Scoped view & mapping headers

Google Workspace to Google Workspace migration

Use the following headers when you're creating a CSV file for a scoped view or mapping for a Google Workspace to Google Workspace migration.

CSV file format

  • All headers and entries are case-sensitive.
  • When using a mapping CSV file, make sure that the column headers belonging to the source connection are prefixed with Source and the target connection column headers are prefixed with Target.
  • Make sure the character encoding of the CSV file is set to UTF-8. 

Example scoped view CSV file for Google Workspace:

Example mapping CSV file for Google Workspace:

In this example, the source domain is example.com. The target domain is solarmora.com.

CSV file headers

Header Use and examples

GCalendar

Must be preceded by a GUser column and value

To map a user’s calendar, use the GCalendar header with the email address of the Google Workspace user and the calendar’s ID. To find the calendar’s ID, go to Create & share a group calendar.

Example
GCalendar
5dr3m09gactu6swuprcct6d@group.calendar.google.com

GCalendarResource To map a calendar resource, use the GCalendarResource header with the calendar resource ID. Find the calendar resource ID by opening your calendar. Point to the calendar resourceand then""and thenSettings and sharing.

Example
GCalendarResource
example.com_37362173432@resource.calendar.google.com

GDrive

Must be preceded by a GUser column and value

To map a user’s My Drive or a shared drive, use the GDrive header with one of the following strings:

  • GMyDrive—Maps the user’s My Drive.
  • GSharedDrives—Maps all shared drives that the user can access.
  • GOrphanedContent—Maps Drive items owned by the user that are unorganized or residing in folders that the user doesn't own.

Example
GDrive
GMyDrive

Note: You can also map unorganized content by using the GService header with the string GDrive.

GFolder

Must be preceded by a GUser column and value

To map a folder inside a user’s My Drive or shared drive, use the GFolder header with the folder’s ID. Find the ID value by navigating to the folder and inspecting the URL. For example, the URL https://drive.google.com/drive/u/0/folders/BDEz25J3DzFb has an ID value of BDEz25J3DzFb.

Example
GFolder
BDEz25J3DzFb

GGroup To map a group in Google Groups, use the GGroup header with the group’s email address.

Example
GGroup
group1@solarmora.com

GOrgUnit To map a specific organizational unit, use the GOrgUnit header and the path to the organizational unit.

Example
GOrgUnit
/Org_Unit/Sub_Org_Unit

GService

Must be preceded by a GUser column and value

To map a user’s Google Workspace service, use the GService header with one of the following strings:

  • GDrive
  • GCalendarService
  • GContactService
  • GMailService

Example
GService
GMailService

GSharedDrive

Must be preceded by a GUser column and value

To map a shared drive, use the GSharedDrive header with the shared drive’s ID. Find the ID value by navigating to the shared drive root folder and inspecting the URL. For example, the URL https://drive.google.com/drive/u/0/folders/BDEz25J3DzFb has an ID value of BDEz25J3DzFb.

Example
GSharedDrive
BDEz25J3DzFb

GUser To map a Google Workspace user, use the GUser header with the email address of the Google Workspace user.

Example
GUser
user1@solarmora.com

MapChildrenOnly

Must be preceded by a column with a folder value

To map the contents of the folder, but not the folder itself, use the MapChildrenOnly header with the (case-insensitive) string "true". To map the folder and its content, omit the column or use the (case-insensitive) string "false".

Example
MapChildrenOnly
true

Sub Path To map a folder that doesn't currently exist in your Google Workspace account, use the Sub Path header. Add the path and name of the new folder below. During a migration, Google Workspace Migrate creates the path and folder and migrates the data to the new folder.

Example
Sub Path
Folder1#Folder2

Related topics


Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.