Use the advanced data import method for Teams

1. In the Google Admin console, go to Menu Data Data import & export Data import Advanced.

   Go to Advanced

   You must be signed in as a super administrator for this task.

2. For Advanced, click Create batch.
3. For Batch name, enter a name for this batch of users and then click Continue.
4. For Data type, click Microsoft Teams and then click Continue.
5. For Client ID, enter the unique ID number for your Exchange Online account.
6. For Client Secret, enter the client secret value for your Azure tenant.
7. For Tenant ID, enter the unique ID number for your Azure tenant.
8. Click Connect.

Create a comma-separated values (CSV) file that lists the teams that you want to import in this batch. You can create a new CSV file. Or, download a sample file and add information. The completed CSV file must be smaller than 10 MB and contain no more than 5,000 users.

To create the CSV file:

1. Using your Workspace administrator account, open a spreadsheet program. Or, in the Admin console, select Download a sample CSV file.
2. Add the header Source MicrosoftTeamsID and enter a Teams ID for each team that you want to import. Use a separate row for each email team.

   Example:

   Source MicrosoftTeamsID

   8f445146-9d80-b020-d50d5589ab

   bd4685f0-61f2-4789-4c1cda85d93

   d0bef58c-9a55-4d8d-976c89n006

3. Save the spreadsheet as a CSV file.
4. Upload the file to the Admin console:
   1. In your Admin console, click Upload CSV.
   2. Select the fileclick Open.
   3. Click Tasks to confirm that the file is successfully uploaded.
5. If the CSV file doesn't successfully upload:
   1. Select the file and click Delete Yes to confirm.
   2. Create a new file and try to upload it again.

   If you encounter this issue more than once, contact Google Workspace support.

If necessary, create a second CSV file (separate from the file of Teams IDs) to map Teams users to Workspace users. You can create a new CSV file. Or, download a sample file and add rows. You don't need to add external users. Their permissions import by default. The completed CSV file must be smaller than 10 MB.

An identity map is not always required. You don't need an identity map if:

• The user's email address in Microsoft is the same as their address in Workspace. For example, the user's email address is raha@example.com for their Microsoft account and their Workspace account.
• All users keep the same username in Workspace and are mapped to another domain name. For example, all users have the domain name @example.com and are moving to the domain name @altostrat.com. The users keep their username and only the domain name changes.

If you have some users that don't need to be mapped and some that do, you can create an identity map for only the users that require mapping.

Create an identity map

1. Using your Workspace administrator account, open a spreadsheet program. Or, in the Admin console, select Download a sample CSV file.
2. In the first column, add the header Source Email and add an email address for each Teams user that you want to import. Use a separate row for each user.
3. In the second column, add the header Destination Email and enter a Workspace email address for each user in the first column. Use a separate row for each user.

   Example:

   Source Exchange Email	Destination Email
   charliecruz@example.com	ccruz@other-company.com
   kailee@example.com	klee@other-company.com
   group@example.com	group@other-company.com

4. Save the spreadsheet as a CSV file.
5. Upload the file to the Admin console:
   1. In your Admin console, click Upload CSV.
   2. Select the fileclick Open.
   3. Click Tasks to confirm that the file is successfully uploaded.
6. If the CSV file doesn't successfully upload:
   1. Select the file and click DeleteYes to confirm.
   2. Create a new file and try to upload it again.

   If you encounter this issue more than once, contact Google Workspace support.

Adjust the following settings to choose which data to copy from Teams.

1. Click Edit settings.
2. For Date range, select a date. The data import tool will copy all Teams events or messages that were sent or received after this date.
3. To import all Teams users, including those not found in the identity map, ensure that the Copy accounts that aren't included in the map that are discovered during the data import box is checked and choose an option:
   • If the user's email address in Teams is the same as their address in Workspace, check the Keep their original address box.
   • If the domain name for all imported users is changing, check the Use a different email address domain for these accounts box and then select a domain from the list.
4. Click Save changes.

Starting a data import grants domain-wide delegation and creates a client ID for data import in Workspace. For more information, go to Control API access with domain-wide delegation.

1. Click Run full import.

   You can see updates on the following information in real time while the data import is in process:

   • Discovered tasks—Number of tasks that were successfully completed
   • Warning—Number of tasks that were completed but failed to complete as expected
   • Failed—Number of tasks that failed to import due to an error
   • Skipped—Number of tasks that were skipped because of certain data import settings, or because they were completed in a previous import
   • Successful—Number of tasks that were successfully completed
   • Channels discovered—Number of channels that were imported, skipped, or failed
   • Spaces created—Number of channels that were imported to spaces
   • Spaces skipped—Number of spaces that weren't created
   • Discovery issues—Number of items that were unable to be read from Microsoft

   You can navigate away from the import page without interrupting the import. Your import continues unless you cancel it.

   When the import is complete, you get an email with import statistics. Any reports are attached.

2. (Optional) To export a report for an import in progress:
   1. Click View data import logs or Export user report.
   2. If the Tasks list doesn't automatically open with the exported report, click Tasks the report link.
   3. Click Open in Google Sheets to open the report in Sheets.
   4. For details about the reports, go to Understand Exchange Online data import reports.

To stop an import that's in progress, click Stop import. It might take a few minutes for the import to stop, and the import process does not roll back. If you're running other batches at the same time, those batches will continue to import.

Any Teams data that was imported before the stop isn't deleted from Workspace.

After you successfully import a batch of data, you can run a delta import to copy any newly added or updated data to Workspace. You can also use a delta import to copy data that failed in the initial import. If you imported the same data in 2 separate batches, a delta import won't create duplicate items as long as you haven't clicked Exit import to remove one of the batches.

For details, go to Run a delta import for chat data.

After you complete the data import, make the imported spaces and messages available to Workspace users. You must complete this process within 90 days of the start of the import, or the imported spaces are deleted.

Important: Don't complete these steps if you still need to run a delta import.

1. In your Google Admin console, click Roll out spaces.

   In real time, you can review the number of spaces and messages that were successfully imported.

2. When the process is complete, click Download logs to view information about which spaces and members were successfully added to users' Google Workspace accounts.

   Note: If any spaces fail to import, click Roll out spaces again to retry the process on all the spaces that failed to import.