Authorize GSMME for your account

G Suite Migration for Microsoft Exchange

Before you use G Suite Migration for Microsoft® Exchange (GSMME), authorize it for your account. The steps vary, depending on whether or not you’re migrating from a G Suite account.

Step 1: Create a service account

Complete the steps in Create a service account.

Step 2: Authorize your Client ID in the Admin console

The instructions depend on the type of account you're migrating from.

Option 1: I'm not migrating from a G Suite account
  1. On the Security page of the Admin console, click Advanced settings.

    You might need to click Show more to see Advanced settings.

  2. In the Authentication section, click Manage API client access.
  3. In the Client Name field, enter your service account's Client ID.

    For details on how to create the Client ID, see Create a service account.

  4. In the One or More API Scopes field, copy and paste the following comma-separated list of scopes:

    https://www.google.com/m8/feeds/,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels

  5. Click Authorize.
  6. Next to the Client ID you entered, make sure all of the scopes appear with a description. If they don't, in the One or More API Scopes field, enter the scopes again and click Authorize.
Option 2: I'm migrating from a G Suite account

The steps you need to take depends on if your G Suite source and destination domains:

  • Differ from one another—Authorize GSMME on both your source and destination domains by following steps 1 and 2 below.
  • Match each other—Authorize GSMME on only your destination domain by following step 2 below.

Step 1: Authorize GSMME on your source domain

  1. Sign in as an administrator on your source domain.
  2. On the Security page of the Admin console, click Advanced settings.

    You might need to click Show more to see Advanced settings.

  3. In the Authentication section, click Manage API client access.
  4. In the Client Name field, enter your service account's Client ID.

    For details on how to create the Client ID, see Create a service account.

  5. In the One or More API Scopes field, copy and paste the following scope: https://www.googleapis.com/auth/gmail.imap_admin
  6. Click Authorize.
  7. Next, complete step 2 below.

Step 2: Authorize GSMME on your destination domain

  1. Sign in as an administrator on your destination domain.
  2. On the Security page of the Admin console, click Advanced settings.

    You might need to click Show more to see Advanced settings.

  3. In the Authentication section, click Manage API client access.
  4. In the Client Name field, enter your service account's Client ID.

    For details on how to create the Client ID, see Create a service account.

  5. In the One or More API scopes field, copy and paste the following comma-separated list of scopes:

    https://www.google.com/m8/feeds/,
    https://www.googleapis.com/auth/admin.directory.group.readonly,
    https://www.googleapis.com/auth/admin.directory.user,
    https://www.googleapis.com/auth/apps.groups.migration,
    https://www.googleapis.com/auth/calendar,
    https://www.googleapis.com/auth/gmail.insert,
    https://www.googleapis.com/auth/gmail.labels,
    https://www.googleapis.com/auth/gmail.imap_admin

  6. Click Authorize.
  7. Next to the Client ID you entered, make sure all of the scopes appear with a description. If they don't, in the One or More API Scopes field, enter the scopes again and click Authorize.

Next step

Set up your migration. For details, see how to migrate data with GSMME.

Was this helpful?
How can we improve it?