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

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

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

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

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

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

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

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

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

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

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