メッセージの詳細を確認する

このガイドでは、次の Message リソースで get メソッドを使用する方法について説明します。 テキスト メッセージやカード メッセージの詳細を返すこともできます。

Chat API では、チャット メッセージは Message リソース。 Chat ユーザーはテキストを含むメッセージしか送信できませんが、 Chat アプリでは、他にもさまざまなメッセージ機能を使用できます。 静的またはインタラクティブなユーザー インターフェースを表示し、 ユーザー、 プライベートでのメッセージの配信などですGoogle Chat 向けの 機能の詳細については、 Google Chat メッセージの概要

前提条件

Python

ユーザー認証を使用してメッセージを取得する

メッセージの詳細を確認するには、 ユーザー認証、 リクエストに以下を渡します。

  • 認可スコープ chat.messages.readonly または chat.messages を指定します。
  • 呼び出し get メソッド 日付 Message リソース
  • name を、取得するメッセージのリソース名に設定します。

次の例では、メッセージに ユーザー認証:

Python

  1. 作業ディレクトリに、chat_message_get_user.py という名前のファイルを作成します。
  2. chat_message_get_user.py に次のコードを含めます。

    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient.discovery import build
    
    # Define your app's authorization scopes.
    # When modifying these scopes, delete the file token.json, if it exists.
    SCOPES = ["https://www.googleapis.com/auth/chat.messages.readonly"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then gets a message.
        '''
    
        # Authenticate with Google Workspace
        # and get user authorization.
        flow = InstalledAppFlow.from_client_secrets_file(
                          'client_secrets.json', SCOPES)
        creds = flow.run_local_server()
    
        # Build a service endpoint for Chat API.
        chat = build('chat', 'v1', credentials=creds)
    
        # Use the service endpoint to call Chat API.
        result = chat.spaces().messages().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'
    
        ).execute()
    
        # Prints details about the message.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. コードの次のように置き換えます。

    • SPACE: スペース名。 spaces.list メソッド スペースの URL から取得できます。
    • MESSAGE: メッセージ名。取得して取得できます。 非同期でメッセージを作成した後に返されるレスポンス本文から Chat API、または カスタム名 自動的に割り当てられます。
  4. 作業ディレクトリでサンプルをビルドして実行します。

    python3 chat_message_get_user.py
    

Chat API は、メッセージに対して Message メッセージの詳細です。

アプリの認証を使用してメッセージを取得する

メッセージの詳細を確認するには、 アプリの認証、 リクエストに以下を渡します。

  • chat.bot 認可スコープを指定します。
  • 呼び出し get メソッド 日付 Message リソース
  • name を、取得するメッセージのリソース名に設定します。

次の例では、メッセージに アプリの認証:

Python

  1. 作業ディレクトリに、chat_get_message_app.py という名前のファイルを作成します。
  2. chat_get_message_app.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().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'
    
      ).execute()
    
    # Print Chat API's response in your command line interface.
    print(result)
    
  3. コードの次のように置き換えます。

    • SPACE: スペースの name 表示されます。この情報は、 spaces.list メソッド スペースの URL から取得できます。

    • MESSAGE: メッセージ名(取得可能) 非同期でメッセージを作成した後に返されるレスポンス本文から Chat API、または カスタム名 自動的に割り当てられます。

  4. 作業ディレクトリでサンプルをビルドして実行します。

    python3 chat_get_message_app.py
    

Chat API は、メッセージに対して Message メッセージの詳細です。