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

○

×