ユーザーデータをインポートする Google Chat アプリの開発の概要

他のメッセージング プラットフォームから Google Chat にユーザーデータをインポートするには、Chat アプリとインポート モードの Chat スペースを作成します。インポート モードのスペースでは、Chat アプリは他のプラットフォームの既存のメッセージ、添付ファイル、リアクション、メンバーシップ、スペース エンティティを同等の REST リソースにインポートできます。インポート処理中に使用できるのは、インポート モードのスペースのみです。Chat アプリは、インポート モードのスペースを作成してから 30 日以内に、スペースのデータのインポートを完了する必要があります。

インポート モードのスペースを使用する理由

インポート モードのスペースは、他のメッセージング プラットフォームから Google Chat に移行するエンドユーザーにとって優れたエクスペリエンスを提供します。ソースデータを通常のスペースにコピーする場合と比べて、インポート モードのスペースには次のようなメリットがあります。

  • リソース作成時のタイムスタンプの保持。スペース リソースとメッセージ リソースの作成時刻に過去の時刻を設定しておくと、ユーザーが Google Chat を導入している間も、チャットアプリに過去のコンテキストが保持されます。詳しくは、Google Chat にデータをインポートするをご覧ください。
  • エンドユーザーはインポート モードでスペースを表示したり、スペースにアクセスしたりできません。データのインポート中のスペースに対するユーザーの干渉を防ぐため、または進行中のデータ インポートを表示してユーザーが混乱しないように、インポート モードのスペースはエンドユーザーに表示されません。スペースのインポート モードが完了したら、ユーザーをスペースに追加できます。
  • Chat では、インポート モード中の通知がオフになっているため、ユーザーは移行に関する不要なアラートを回避できます。

インポート モードのスペースでサポートされている Google Chat リソース

インポート モードのスペースを使用して、次の Google Chat API リソースをインポートできます。

  • メッセージ
  • 添付ファイル
  • リアクション
  • メンバーシップについて、次の点を考慮してください。

    • スペースがインポート モードの場合は、過去のメンバーシップをインポートする必要があります。スペースがインポート モードを完了すると、過去のメンバーシップをインポートできなくなります。
    • スペースがインポート モードを完了した後に、ソース メッセージング プラットフォームからの他の既存のメンバーシップを作成する必要があります。
    • メンバーは同じドメイン内のユーザーである必要があります。
  • スペースSpaceType.SPACE のみがサポートされています。

ソースデータを Google Chat リソースにマッピングする

ソース メッセージング プラットフォームから Google Chat にデータをインポートする場合は、Chat で作成できるサポート対象リソースを確認してください。次に、インポートするソース エンティティを決定し、各エンティティを Chat リソースにマッピングします。リソース マッピングを計画したら、ソース メッセージング プラットフォームからエンティティを読み取り、インポート モードのスペースに書き込みます。