TeamsからGoogle Chatへ移行するツールを検証してみた

2024年3月22日にGoogle Chat APIとして他のチャットツールからの受け口になるAPIがリリースされました。しかしAPIなので他のチャットツールからの移行となると「移行ツールを自分で作る」必要性があります。対応してる移行ツールも少ないですがありますが、その為にコストを払って・・・というのも考えものです。

しかし、2024年12月17日、Google公式からMicrosoft TeamsからGoogle Chatへのチャンネルデータ移行ツールがリリースされました。Google Chat APIとMicrosoft Graph APIを使って移行してるものと思います。今回これを使って移行を検証してみたいと思います。

1 今回利用するツール
2 事前準備
3 移行を実行する
4 関連リンク

今回利用するツール

管理コンソール上から作業を行う必要があるため特権管理者の権限が必要な点と、Microsoft Teamsの「チャンネルデータ」を移行する為、Microsoft365側の特権管理者権限が必要になります。

また、チャンネルデータなので「個人のチャット」については移行対象外のようです。移行対象に関してはこちらに一覧表でまとめられています。ボットのメッセージも移行対象外で、スレッドも最大500件までと制限が付けられています（まぁ、500件もスレッドで返信することはあまりないと思いますが）。

また、Teamsのチャンネルへの投稿時の添付ファイルはSharepointにアップロードされて管理されますが、これも移行対象外となります。

事前準備

以下の作業はすべてGoogle Workspaceの管理コンソール側で行います。すでに利用可能な状態となっているので、管理者権限があれば移行を実行することが可能です。

Microsoft365と接続する

以下の手順で移行ツールとMicrosoft365を接続する必要があります。

管理コンソールにログインする
左サイドバーより、データ→データのインポートとエクスポート→データ移行（新規）をクリックする
パネルに「Microsoft Teams」があるので、移行をクリックする
Microsoftアカウントに接続するをクリックする
Microsoftアカウントログイン画面になるので、M365側特権管理者のアカウントでログインする
要求されているアクセス許可が出てくるので、承諾をクリックする

これで接続は完了しました。

図：既にツールが用意されています。

図：要求されるスコープ

移行マップデータを作成する

Teamsのチャンネルリストを取得する

TeamsのチャンネルIDを一つずつ取得するのはダルすぎるので、Teams管理センターを開く
左サイドバーよりTeams→チームを管理を開く
テナント内の全チームがリストアップされてるので全部選択する
Excelアイコンのエクスポートをクリックする
しばらく待つと上部通知欄のダウンロードにリンクが出るのでクリックするとCSVがダウンロードされる

このファイルを開くと、「Groups Id」という列があり、これがチャンネルのIDとなります。

図：Teams管理センターから作業を行う

移行マップCSVを作成する

移行させるTeamsのチャンネルIDをまとめたCSVファイルを作成する必要があります。前述の手順からの続きとなります。このリストは10MB未満且つ150,000行未満である必要があります。

前述の手順のステップ2にある「サンプルCSVをダウンロード」をクリックする。（migration_maps_sample.csvというファイルがダウンロードされます）
LibreOfficeなどのツールでサンプルCSVを開く
Source MicrosoftTeamsIDの列に前述のTeams管理センターから入手したリストのGroup IDを列挙していく
CSVとして保存し直す
管理コンソール側のステップ2の「移行マップのCSVをアップロード」をクリックして、CSVファイルを指定します。

これで移行マップCSVファイルは完成しアップロードも完了しました。

図：チャンネルIDを列挙しただけのCSV

IDマップを作成する

IDマップとは何か？というと、Google Workspace側で利用してるドメインやユーザのメアドと、Microsoft365側で利用してるドメインとユーザのメアドが異なる場合、そのままでは当然移行が出来ませんので、これを1:1で対応するのがIDマップです。移行元と移行先との間でアカウントを一致させる必要があり、これをもとに権限などを保持します。

以下の手順でCSVを作成してアップロードする必要があります。

管理コンソールのステップ3における「サンプルCSVをダウンロード」をクリックしてダウンロードする（identity_maps_sample.csvというファイルがダウンロードされます）
Source Emailの列はMicrosoft365側のユーザのユーザプリンシパルネーム等を入れる（いわゆるメアド）
Destination Emailの列はGoogle Workspace側のユーザのメアドを入れる
CSVとして保存し直す
管理コンソール側のステップ３の「IDマップのCSVをアップロード」をクリックして、CSVファイルを指定します。

これでマッピングまで含めて完了しました。