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

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

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

Google Workspace ドメイン管理者のみが、ドメイン全体の委任を使用して、この OAuth スコープをサービス アカウントに付与できます。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

○

×