このガイドでは、
get()
メソッドを Google Chat API の Message
リソースで使用すると、
カードメッセージです。
Chat API では、Chat メッセージは Message
リソースで表されます。Chat ユーザーはテキストを含むメッセージのみを送信できますが、Chat アプリでは、静的またはインタラクティブなユーザー インターフェースの表示、ユーザーからの情報の収集、メッセージの非公開送信など、他の多くのメッセージ機能も使用できます。Google Chat 向けの
機能の詳細については、
Google Chat メッセージの概要
前提条件
Node.js
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。
- 環境を設定します。
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud プロジェクトを作成します。
- OAuth 同意画面を構成する
- Google Chat API を有効にして構成する。名前、 アプリのアイコン、説明を入力します。
- Node.js Cloud クライアント ライブラリをご覧ください。
- Google Chat API リクエストで認証する方法に基づいて、アクセス認証情報を作成します。
- Chat ユーザーとして認証するには、
OAuth クライアント ID を作成する
認証情報を JSON ファイルとして保存し、
client_secrets.json
をローカル ディレクトリに移動します。 - Chat 用アプリとして認証するには、
サービス アカウントの作成
認証情報を JSON ファイルとして保存し、
credentials.json
。
- Chat ユーザーとして認証するには、
OAuth クライアント ID を作成する
認証情報を JSON ファイルとして保存し、
- ユーザーとして認証するか、Chat アプリとして認証するかに応じて、認可スコープを選択します。
- 認証済みユーザーまたは呼び出し元の Chat アプリがメンバーである Google Chat スペース。ID プロバイダとして認証するには、 Chat 用アプリで Chat アプリをスペースに追加できます。
Python
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。
- 環境を設定します。
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud プロジェクトを作成します。
- OAuth 同意画面を構成する
- Google Chat API を有効にして構成し、Chat アプリの名前、アイコン、説明を指定します。
- Python Cloud クライアント ライブラリをご覧ください。
- Google Chat API での認証方法に基づいてアクセス認証情報を作成する
request:
<ph type="x-smartling-placeholder">
- </ph>
- Chat ユーザーとして認証するには、
OAuth クライアント ID を作成する
認証情報を JSON ファイルとして保存し、
client_secrets.json
をローカル ディレクトリに移動します。 - Chat アプリとして認証するには、サービス アカウントの認証情報を作成し、認証情報を
credentials.json
という名前の JSON ファイルとして保存します。
- Chat ユーザーとして認証するには、
OAuth クライアント ID を作成する
認証情報を JSON ファイルとして保存し、
- ユーザーとして認証するか、Chat アプリとして認証するかに応じて、認可スコープを選択します。
- 認証されたユーザーまたはスペースでやり取りされる Google Chat スペース 1 人です。ID プロバイダとして認証するには、 Chat 用アプリで Chat アプリをスペースに追加できます。
Java
- Google Chat へのアクセス権を持つビジネスまたはエンタープライズ向け Google Workspace アカウント。
- 環境を設定します。
- Google Cloud プロジェクトを作成します。
- OAuth 同意画面を構成する
- Google Chat API を有効にして構成し、Chat アプリの名前、アイコン、説明を指定します。
- Java Cloud クライアント ライブラリをご覧ください。
- Google Chat API での認証方法に基づいてアクセス認証情報を作成する
request:
<ph type="x-smartling-placeholder">
- </ph>
- Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を
client_secrets.json
という名前の JSON ファイルとしてローカル ディレクトリに保存します。 - Chat アプリとして認証するには、サービス アカウントの認証情報を作成し、認証情報を
credentials.json
という名前の JSON ファイルとして保存します。
- Chat ユーザーとして認証するには、OAuth クライアント ID 認証情報を作成し、認証情報を
- ユーザーとして認証するか、Chat アプリとして認証するかに応じて、認可スコープを選択します。
- 認証済みユーザーまたは呼び出し元の Chat アプリがメンバーである Google Chat スペース。ID プロバイダとして認証するには、 Chat 用アプリで Chat アプリをスペースに追加できます。
Apps Script
- Google Chat へのアクセス権を持つビジネスまたはエンタープライズ向け Google Workspace アカウント。
- 環境を設定します。
- Google Cloud プロジェクトを作成します。
- OAuth 同意画面を構成する
- Google Chat API を有効にして構成する。名前、 アプリのアイコン、説明を入力します。
- スタンドアロンの Apps Script プロジェクトを作成する [高度なチャット サービス] をオンにします。
- このガイドでは、ユーザー アカウントまたは またはアプリ認証を使用します。Chat アプリとして認証するには、サービス アカウントの認証情報を作成します。手順については、以下をご覧ください。 Google Chat アプリ。
- ユーザーとして認証するか、Chat アプリとして認証するかに応じて、認可スコープを選択します。
- 認証済みユーザーまたは呼び出し元の Chat アプリがメンバーである Google Chat スペース。Chat アプリとして認証するには、Chat アプリをスペースに追加します。
<ph type="x-smartling-placeholder">
ユーザー認証付きのメッセージを取得する
メッセージの詳細を確認するには、 ユーザー認証、 リクエストに以下を渡します。
chat.messages.readonly
またはchat.messages
の認可スコープを指定します。GetMessage()
メソッドを呼び出します。name
を、取得するメッセージのリソース名に設定します。
次の例では、メッセージに ユーザー認証:
Node.js
Python
Java
Apps Script
このサンプルを実行するには、次のように置き換えます。
SPACE_NAME
: スペースのname
の ID。ID は、ListSpaces()
メソッドを呼び出すか、スペースの URL から取得できます。MESSAGE_NAME
: メッセージの IDname
。 ID は、Chat API を使用してメッセージを非同期で作成した後に返されたレスポンス本文から取得できます。また、作成時にメッセージに割り当てられたカスタム名を使用して取得することもできます。
Chat API は、指定されたメッセージの詳細を示す Message
のインスタンスを返します。
アプリ認証でメッセージを取得する
アプリ認証を使用したメッセージの詳細を取得するには、リクエストで次の情報を渡します。
chat.bot
認可スコープを指定します。GetMessage()
メソッドを呼び出します。name
を、取得するメッセージのリソース名に設定します。
次の例では、メッセージに アプリの認証:
Node.js
Python
Java
Apps Script
このサンプルを実行するには、次のように置き換えます。
SPACE_NAME
: スペースの IDname
。 ID を取得するには、このメソッドを呼び出して、ListSpaces()
スペースの URL から取得できます。MESSAGE_NAME
: メッセージの IDname
。 ID は、Chat API を使用してメッセージを非同期で作成した後に返されたレスポンス本文から取得できます。また、作成時にメッセージに割り当てられたカスタム名を使用して取得することもできます。
Chat API は、指定したメッセージの詳細を示す Message
のインスタンスを返します。