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 アプリがインポート モードのスペースで呼び出すことができるリソース メソッドと、サポートされる認証の種類を示します。
リソース メソッド |
ユーザーの権限借用に対応 |
サポートされているサービス アカウント認証情報 |
---|---|---|
|
○ |
× |
|
× |
○ |
|
○ |
× |
|
○ |
× |
|
○ |
× |
|
○ |
○ |
|
○ |
○ |
|
× |
○ |
|
○ |
× |
|
○ |
○ |
|
○ |
× |
|
○ |
× |
|
○ |
× |
|
○ |
× |
|
○ |
× |
|
○ |
× |
関連トピック
- 認証と認可の詳細については、Google Chat アプリと API リクエストの認証と承認をご覧ください。
- インポート モードのスペースを使用してリソースのインポートを開始する方法については、Google Chat にデータをインポートするをご覧ください。