Receber metadados sobre um anexo de mensagem

Este guia explica como usar o método get no recurso Media da API Google Chat para receber metadados sobre um anexo de mensagem. A resposta é uma instância do Recurso Attachment.

Quando o usuário envia uma mensagem para seu app, o Google Chat envia uma Evento de interação MESSAGE. O evento de interação recebido pelo seu aplicativo inclui um corpo de solicitação, que é o Payload JSON que representa o evento de interação, incluindo qualquer anexo. A os dados no anexo serão diferentes se ele for conteúdo enviado por upload (arquivo local) ou armazenado no Drive. A Recurso Media representa um arquivo enviado para o Google Chat, como imagens, vídeos e documentos. A Recurso Attachment representa uma instância de mídia (um arquivo) anexada a uma mensagem. O Attachment recurso inclui os metadados sobre o anexo, como onde eles serão salvos.

Pré-requisitos

Python

Receber um anexo de mensagem

Para receber metadados de maneira assíncrona sobre um anexo de mensagem no Google Chat, transmita o seguinte na sua solicitação:

Veja como conseguir metadados sobre um anexo de mensagem:

Python

  1. Em seu diretório de trabalho, crie um arquivo chamado chat_get_message_attachment.py:
  2. Inclua o seguinte código em 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)
    
  3. No código, substitua spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT com o nome do anexo da mensagem.

  4. No diretório de trabalho, crie e execute o exemplo:

    python3 chat_get_message_attachment.py
    

A API Chat retorna uma instância do Attachment que detalha os metadados sobre o anexo de mensagem especificado.