他のメッセージング プラットフォームから Google Chat にユーザーデータをインポートするには、Chat アプリとインポート モードの Chat スペースを作成します。インポート モードのスペースでは、Chat アプリは他のプラットフォームから既存のメッセージ、添付ファイル、リアクション、メンバーシップ、スペース エンティティを同等の REST リソースにインポートできます。インポート モードのスペースは、インポート プロセス中のみ使用できます。
インポート モードのスペースを使用する理由
インポート モードのスペースを使用すると、他のメッセージング プラットフォームから Google Chat に移行するエンドユーザーのエクスペリエンスが向上します。ソースデータを通常のスペースにコピーする場合と比較して、インポート モードのスペースの使用には次のような利点があります。
- リソース作成タイムスタンプの保持。スペース リソースとメッセージ リソースの作成時刻に履歴時刻を設定すると、ユーザーが Google Chat を導入する際に Chat アプリが過去のコンテキストを保持できます。詳細については、Google Chat にデータをインポートするをご覧ください。
- インポート モードでは、エンドユーザーはスペースを表示したり、スペースにアクセスしたりできません。データ インポート中のスペースへのユーザーの干渉を防ぐため、または進行中のデータ インポートを表示してユーザーが混乱することのないように、インポート モードのスペースはエンドユーザーに対して非表示になります。スペースのインポート モードが完了したら、ユーザーをスペースに追加できます。
- インポート モードでは通知がオフになるため、ユーザーは移行に関する不要なアラートを回避できます。
インポート モードのスペースでサポートされている Google Chat リソース
インポート モードのスペースを使用して、次の Google Chat API リソースをインポートできます。
- メッセージ
- 次の点を考慮したアタッチメント:
- 添付ファイルは、Google Chat API を使用してインポート モードのスペースにアップロードできます。ただし、Google Drive API を使用してファイルをアップロードし、インポート モードのスペースでファイルの URI をそれぞれのメッセージにリンクすることを強くおすすめします。これにより、Google Chat での添付ファイルのアップロードに関する内部制限に達することを回避できます。
- リアクション
メンバーシップ。ただし、次の点に注意してください。
- スペースがインポート モードのときに、過去のメンバーシップをインポートする必要があります。インポート モードの完了後に過去のメンバーシップをインポートすることはできません。
- インポート元のメッセージング プラットフォームの他の既存のメンバーシップは、インポート モードの完了後に作成する必要があります。
- メンバーは同じドメイン内のユーザーである必要があります。
スペース。
SpaceType.SPACE
のみがサポートされています。
ソースデータを Google Chat リソースにマッピングする
ソース メッセージング プラットフォームから Google Chat にデータをインポートする際は、Chat で作成できるサポート対象のリソースを確認してください。次に、インポートするソース エンティティを決定し、各エンティティを Chat リソースにマッピングします。リソース マッピングを計画したら、ソース メッセージング プラットフォームからエンティティを読み取り、インポート モードのスペースに書き込みます。
関連トピック
- インポート モードのスペースの使用時に Chat API で認証する方法については、Google Chat アプリを承認するをご覧ください。
- インポート モードのスペースを使用してリソースのインポートを開始する方法については、Google Chat にデータをインポートするをご覧ください。