Supported editions for this feature: Business Starter, Business Standard, and Business Plus; Enterprise Standard and Enterprise Plus; Education Fundamentals, Education Standard, Teaching and Learning Upgrade, and Education Plus; Essentials Starter, Essentials, Enterprise Essentials, and Enterprise Essentials Plus; Nonprofits; G Suite Basic and G Suite Business. Compare your edition
Migrating files from SharePoint Online using the new data migration service is currently in beta and subject to the Pre-General Availability Offerings Terms in the Google Workspace Service Specific Terms.
You can access a report with detailed information on the items in your Microsoft SharePoint Online migration.
Access the report
You must be signed in as a super administrator for this task.
-
Sign in with a super administrator account to the Google Admin console.
If you aren’t using a super administrator account, you can’t complete these steps.
- At the top, click Go to data migration (New).
- For Microsoft SharePoint Online, click Migrate.
- Click Export migration report.
- If the Tasks list doesn't open automatically with the downloaded report, click Tasks
.
- For Your Tasks, click the link to open the report in Google Sheets.
Interpret the migration report
You can use the migration report to identify items that didn't migrate and the reasons they weren’t copied.
|
Error report field |
Description |
|---|---|
|
Status |
The migration status of the item (example: warning, error) |
| Error or warning code and description |
The code and message associated with the error or warning message. For help, go to Troubleshoot common error & warning messages. |
|
Processing start time |
When the item started to migrate |
|
Processing end time |
When the item migration was complete |
|
Source type & source identifier |
sites/siteUrl
sites/siteUrl/drives/drive
site/siteUrl/drives/drive_id/folders/folder_id
sites/siteUrl/drives/drive_id/files/file_id
|
|
Source URL |
URL of the item in SharePoint Online |
|
Target type and target identifier |
folders/folder_id
files/file_id
|
|
Target URL |
URL of the target item in Workspace |
Troubleshoot common error & warning messages
If you get an error that's not mentioned in this table, try running a delta migration.
|
Error message |
Description & troubleshooting help |
|---|---|
|
An error occurred while calling source side Need admin approval |
The data migration tool wasn’t able to connect to your SharePoint Online account.
|
|
Failed to crawl parent item permissions while crawling permissions for Drive ID drive_id and source ItemId item_id |
A temporary error. Run a delta migration. |
| Failed to crawl folder for Drive ID: drive_id, Folder ID: folder_id |
The folder crawling failed from SharePoint Online.
|
|
Found microsoft drive item with restricted permissions. Drive id: drive_id, Item id: item_id. |
A SharePoint Online file or folder has restricted permissions. Items with restricted permissions are not supported by the tool. |
| Atleast <role> role is required on target item to perform step: <step> |
A file or folder has insufficient permissions.
For example, if you get the error message Atleast WRITER role is required on target item to perform step: SHAREPOINT_SITE_CREATOR, then you need to add the required permissions. |
| TargetGUser does not have edit access on target parent folder | The Workspace user does not have Manager permission on the folder in shared drives.
|
|
File has been modified |
File was modified while migration was in progress. Run a delta migration. |
|
File was deleted during migration |
File was deleted in SharePoint Online while the migration was in progress. Run a delta migration. |
| Item modified by application on source migrated with file owner as modifier | File or folder was modified by an application. This is a warning and does not block migration. |
| Item created by application on source migrated with drive owner as creator | File or folder was created by an application. This is a warning and does not block migration. |
| Failed to create permissions for driveId exampleDriveId for recipients [recipient1, recipient2] due to invalid target identity | Permission could not be created because the user does not exist in Workspace. This error could be due to an error in the identity mapping or a source that was incorrectly imported through unmapped identity settings. Resolve the issue and run a delta migration. |
| Item creator email address is invalid or does not exist | Failed to create permissions for a file or folder owner due to invalid target identity. Check the identity map or unmapped identity settings for mistakes and then run a delta migration. |
| Mapped creator does not have access to edit the target item, Target GUser mapped as creator | File or folder was not mapped to Workspace. This is a warning and does not block migration. |
| TargetGUser does not have access on target parent folder | The Workspace user needs edit access to the parent folder of the failed file or folder.
|
| Ensure that target folder <folderId> exists and <targetGUser> has manager access to it | Make sure the Workspace user specified in the sites and site collections file has Manager permissions for the shared drive. |
| Target folder <folder> needs to be under a shared drive | The folder ID specified in the sites and site collections file does not correspond to a shared drive. Update the file with the correct folder ID. |
|
Error occurred while generating user credential. Domain wide delegation can take up to 24 hours but typically happens more quickly. Please try running a delta migration after few hours |
Transient issue that sometimes occurs for newly created users. Wait a while and then run a delta migration. |
| Item cannot be migrated since the item creator is not part of the source organization | File or folder owner is an external user or is not part of your organization. This file or folder cannot be migrated. |
| We weren't able to share your file with [email protected] There's a problem with this email or domain | User email address is invalid or does not exist. Check the identity map or unmapped identity settings for errors. |
| User provided in identity mapping does not belong to a Workspace customer |
The identity map has an invalid Workspace email address.
|
| Internal error occurred | A temporary error. Run a delta migration. |
| Found entries missing in the identity mapping for <username> |
A SharePoint Online user is not mapped to a Workspace user in the identity map.
|
| The item shared with "Anyone with the link" on the source could not be shared with the same setting on the target file on Google Drive | Anonymous link permission was not migrated for the item. For details, go to Manage external sharing for your organization. |
| Google Drive storage quota has been exceeded. Please increase the storage quota to migrate more data. | Drive storage quota is exceeded. Increase storage to migrate more data. For details, go to Storage and upload limits for Google Workspace. |
| Failed to crawl site as one of the upstream dependency task for site: site_url has failed. |
A parent folder failed to migrate, and it wasn’t possible to crawl any of its child folders.
|
| Temporary error in file migration, try running a delta migration | File was modified in SharePoint Online when a migration was in progress. Run a delta migration to try again. |
| The shared drive hierarchy depth will exceed the limit | Nested folder limit reached for this shared drive. Move deeper level items to a higher level and then run a delta migration. For details, go to Shared drive limits in Google Drive. |
| The file limit for this shared drive has been exceeded | File limit reached for this shared drive. Try migrating subsites to new shared drives or rearrange the data in SharePoint Online. For details, go to Shared drive limits in Google Drive. |
| The provided URL is invalid or does not represent a site | Site URL in the migration map does not correspond to a valid site URL. Please update the URL and then run a delta migration. |
| Mapped version owner does not have access to edit the target item, Target GUser mapped as modifier | The last modifying user resolved through the identity mapping does not have edit access, so Target GUser was made the last modifier for this item. This does not block migration. |
| Target GUser [emailID] has reached the item creation limit in Google Drive. Use a different Target GUser. | Item creation limit reached for the Target GUser. The maximum number of Drive items that can be created by a single Target GUser is 300,000.
|
| Target Creator [emailID] has reached the item creation limit in Google Drive. | File creation limit exceeded by the Target Creator. The maximum number of Drive items that can be created by a single Target Creator is 300,000.
|
| Mapped last modifying user does not have access to the target item, Target GUser for update | Last modifying user resolved through the identity mapping does not have edit access, so Target GUser was made the last modifier for this item. This does not block migration. |
| Mapped Target GUser does not have access to edit the target item | Target GUser does not have access to edit the item. Add edit access and then run a delta migration. |
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.
