このガイドでは、次のリソースの Media
リソースで get
メソッドを使用する方法について説明します。
メッセージの添付ファイルに関するメタデータを取得するための Google Chat API。レスポンスは
Pod の
Attachment
リソース。
ユーザーがアプリにメッセージを送信すると、Google Chat は
MESSAGE
インタラクション イベント。
アプリが受け取るインタラクション イベントには、リクエスト本文が含まれます。これは、
操作イベント(添付ファイルを含む)を表す JSON ペイロード。「
添付ファイルに含まれるデータは、その添付ファイルが
アップロード済みコンテンツ(ローカル ファイル)、ドライブに保存されているファイルなどです。「
Media
リソース
とは、Google Chat にアップロードされるファイル(画像、動画、ドキュメントなど)を表します。
「
Attachment
リソース
メッセージに添付されたメディア(ファイル)のインスタンスを表します。Attachment
リソースには、次のような添付ファイルに関するメタデータが含まれます。
保存されます。
前提条件
Python
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。
- 環境を設定します。
<ph type="x-smartling-placeholder">
- </ph>
- Google Cloud プロジェクトを作成します。
- OAuth 同意画面を構成します。
- Google Chat API を有効にして構成する。名前、 アプリのアイコン、説明を入力します。
- <ph type="x-smartling-placeholder"></ph>
デスクトップ アプリケーション用の OAuth クライアント ID 認証情報を作成するサンプルを実行するには、
で、認証情報を
client_secrets.json
という名前の JSON ファイルとして ディレクトリにあります。
- <ph type="x-smartling-placeholder"></ph> ユーザー認証をサポートする認可スコープを選択します。
メッセージの添付ファイルを取得する
Google Chat でメッセージの添付ファイルに関するメタデータを非同期で取得するには、 次のコードを追加します。
chat.bot
認可スコープを指定します。- 呼び出し
get
メソッド 日付Attachment
リソース、 - メッセージの添付ファイルの
name
を渡します。
メッセージの添付ファイルに関するメタデータを取得する方法は次のとおりです。
Python
- 作業ディレクトリに、先ほど作成した
chat_get_message_attachment.py
。 chat_get_message_attachment.py
に次のコードを含めます。from google.oauth2 import service_account from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ( service_account.Credentials.from_service_account_file('credentials.json') .with_scopes(SCOPES) ) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=CREDENTIALS) # Get a Chat message. result = chat.spaces().messages().attachments().get( # The message to get. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. # # Replace MESSAGE with a message name. # Obtain the message name from the response body returned # after creating a message asynchronously with Chat REST API. name='spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT' ).execute() # Print Chat API's response in your command line interface. print(result)
コード内の
spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT
付けられた名前が表示されます。作業ディレクトリでサンプルをビルドして実行します。
python3 chat_get_message_attachment.py
Chat API は、メッセージに対して
Attachment
指定したメッセージの添付ファイルに関するメタデータの詳細を記述します。