Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Introduction
Microsoft 365 Exchange Online migration is launching a Google Workspace (GWS) mailbox to Exchange Online (EXO) mail migration solution called Simplified Gmail Migration (SGM) in the Microsoft 365 Admin Center (MAC). This new solution enables admins at small and medium-sized businesses in the early stages of performing Exchange administration responsibilities to complete mail migration for their organization.
To make the migration from GWS mail to EXO a seamless experience, we're introducing a Google marketplace app called “Microsoft 365 Mail Migration”. This article explains the purpose and the details of the app, and also provides you a link to the SGM solution in MAC.
Note
To install this app in your Google Admin console, you need administrator privileges.
Purpose
When you, the tenant admin in charge of migration, log into the MAC, you can start your SGM experience from the Google Workspace Migration page.
You need to log in to the Google Admin Console using your admin credentials. The experience then guides you to install the Microsoft 365 Mail Migration app from the Google marketplace in your Google Admin Console.
By installing the app, you're granting the following permissions via the respective APIs:
| Purpose | API |
|---|---|
| Get primary domain when creating migration endpoint | https://www.googleapis.com/auth/admin.directory.customer.readonly |
| Get tenant user count | https://www.googleapis.com/auth/admin.reports.usage.readonly |
| Get ID token | https://www.googleapis.com/auth/userinfo.email |
| Scan tenant users | https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly |
| Migrate Contacts | https://www.googleapis.com/auth/contacts |
| Migrate Tasks | https://www.googleapis.com/auth/tasks.readonly |
| Migrate Calendar | https://www.googleapis.com/auth/calendar |
| Migrate Gmail | https://www.googleapis.com/auth/gmail.settings.sharing https://www.googleapis.com/auth/userinfo.email [https://www.googleapis.com/auth/userinfo.profile]https://www.googleapis.com/auth/userinfo.profile https://mail.google.com/ |
The app includes an OAuth2 client and a service account. The OAuth2 client is used to do Google OAuth and the service account is used for migration purposes. The app will create a migration endpoint, and query the GWS primary domain to scan and present tenant user and resource information. With the permissions mentioned in this article being granted, the service account will sync the user's data of your selection from GWS to EXO. In this experience, you choose the data (Mail, Calendar, Contacts, Tasks, Rules, Permissions, and Delegates) as well as the duration (all or between date ranges) you want to migrate for each user.
Important
The app does not modify or delete your data from GWS mail, calendar, contacts, or tasks.
Ready to migrate your GWS mailboxes to Microsoft 365 Exchange?
When you're ready to migrate, start your migration from the consolidated Google Workspace Migration page, where you can migrate not only your GWS mailboxes but your GWS Drive contents as well.
Important
See the Microsoft privacy assurance for enterprise solutions in this article: Privacy & Data Management Overview.