Google Chat アプリにデータのインポートを許可する

Google Chat API を使用すると、アプリはインポート モードのスペースを使用して、他のメッセージング プラットフォームから Google Chat にデータをインポートできます。詳しくは、別のサービスから Google Chat にメッセージ データをインポートするをご覧ください。

インポート モードのスペースでリソースを読み書きするには、サービス アカウントで Chat アプリを認証する必要があります。管理者がサービス アカウントに次の Chat API 認可スコープ（https://www.googleapis.com/auth/chat.import）を付与します。

この OAuth スコープをサービス アカウントに付与できるのは、ドメイン全体の委任を行う Google Workspace ドメイン管理者のみです。Chat アプリがインポート モードのスペースを作成するすべてのドメインに、この OAuth スコープが必要です。サービス アカウントにこのスコープのドメイン全体の権限が委任されると、Chat アプリはユーザー アカウントの権限借用によってインポートモードのスペースにアクセスできます。

シナリオによっては、権限借用用のユーザー アカウントが使用できなくなることがあります。このような場合、Chat アプリはサービス アカウントの認証情報をフォールバックとして使用できます。たとえば、メッセージの作成時に使用したユーザー アカウントを削除した場合、Chat アプリは独自のサービス アカウント認証情報を使用して、同じ内容のメッセージを作成できます。Chat アプリは、OAuth スコープ https://www.googleapis.com/auth/chat.bot を持つサービス アカウント認証情報を使用して、アプリとしてインポートモードのスペースにアクセスできます。

インポート モードのスペースにリソースをインポートする場合、他の Google Chat API スコープは必要ありません。Chat アプリは、作成したインポート モードのスペースにのみコンテンツをインポートできます。他のアプリが作成したインポート モードのスペースにはインポートできません。

次の表に、Chat アプリがインポート モードのスペースで呼び出せるリソース メソッドと、サポートされている認証の種類を示します。

リソース メソッド

ユーザーの権限借用がサポートされている

サポートされているサービス アカウント認証情報

spaces.create

○

いいえ

spaces.get

×

○

spaces.update

○

いいえ

spaces.delete

はい

いいえ

spaces.completeImport

はい

いいえ

spaces.messages.create

○

○

spaces.messages.delete

○

○

spaces.messages.get

いいえ

○

spaces.messages.list

○

いいえ

spaces.messages.update

○

○

spaces.messages.reactions.create

○

いいえ

spaces.messages.reactions.delete

はい

いいえ

spaces.members.create

はい

いいえ

spaces.members.delete

はい

いいえ

spaces.members.list

はい

いいえ

media.upload

はい

いいえ