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