Skip to main content

Google Workspace migration assessment

How to connect your Google Workspace and run a migration assessment to understand the scope of your project before you start.

Use the migration assessment to understand the scope of a Google Workspace migration project before you start. This article covers how to connect your Google Workspace and run the assessment.

Prerequisites

Before you start, make sure you have the following:

  • A ShareGate Migrate subscription with migration assessment access (currently available to select partners)

  • A Super Admin (domain admin) role in Google Workspace

Connect your Google Workspace

  1. Sign in to ShareGate Home and open the Migration Assessment.

  2. Click New assessment.

  3. Select Google Workspace.

  4. Click Connect with Google and sign in with your super admin account.

  5. When prompted, add ShareGate Migration Assessment to your Google Workspace allowlist in the Google Admin Console. See Add ShareGate to your Google Workspace allowlist below.

  6. Once authorized, return to the assessment. It starts loading automatically.

Note: Loading time depends on the size of your Google Workspace environment. Large environments may take several minutes.

Add ShareGate to your Google Workspace allowlist

A super admin must authorize ShareGate Migration Assessment in the Google Admin Console before the assessment can access your data.

  1. Sign in to the Google Admin Console.

  2. Go to Security, then Access and data control, then API controls.

  3. Click Manage Domain Wide Delegation.

  4. Click Add new.

  5. In the Client ID field, enter 114335206116188753672.

  6. In the OAuth scopes field, enter the following scopes separated by commas:

    https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/gmail.readonly

  7. Click Authorize.

Note: These permissions give ShareGate read-only access to your Google Drive files, user directory, and Gmail data. No data is modified.

What the assessment covers

Once complete, the Google Workspace migration assessment gives you details about your environment to help plan your migration:

  • Users and their license status

  • Google Drive storage and file counts

  • Gmail mailbox sizes

Click Export to download your full assessment as a CSV file.

Did this answer your question?