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

○

いいえ