Pobieranie metadanych załącznika wiadomości

Z tego przewodnika dowiesz się, jak używać metody get w zasobie Media funkcji interfejsu Google Chat API do pobierania metadanych załącznika do wiadomości. Odpowiedź to wystąpienia Attachment zasób.

Gdy użytkownik wysyła wiadomość do Twojej aplikacji, Google Chat wysyła komunikat MESSAGE zdarzenia interakcji. Zdarzenie interakcji odebrane przez aplikację zawiera treść żądania, która jest Ładunek JSON reprezentujący zdarzenie interakcji, wraz ze wszystkimi załącznikami. dane w załączniku będą się różnić w zależności od tego, czy został przesłane treści (plik lokalny) lub plik zapisany na Dysku; Media zasób reprezentuje plik przesłany do Google Chat, np. obrazy, filmy i dokumenty. Attachment zasób reprezentuje instancję multimediów – pliku – dołączonego do wiadomości. Attachment zasób zawiera metadane dotyczące załącznika, takie jak gdzie są zapisywane.

Wymagania wstępne

Python

  • Python w wersji 3.6 lub nowszej
  • narzędzie do zarządzania pakietami pip;
  • Najnowsze biblioteki klienta Google. Aby je zainstalować lub zaktualizować: uruchom następujące polecenie w interfejsie wiersza poleceń: 
    pip3 install --upgrade google-api-python-client google-auth-oauthlib

Pobieranie załącznika do wiadomości

Aby asynchronicznie uzyskać metadane załącznika wiadomości w Google Chat, przekaż następujące elementy w żądaniu:

Aby uzyskać metadane załącznika wiadomości:

Python

  1. W katalogu roboczym utwórz plik o nazwie chat_get_message_attachment.py

  2. Umieść w pliku chat_get_message_attachment.py ten kod:

    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. W kodzie zastąp spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT nazwa załącznika do wiadomości.

  4. W katalogu roboczym skompiluj i uruchom przykład:

    python3 chat_get_message_attachment.py

Interfejs Chat API zwraca instancję Attachment ze szczegółami dotyczącymi metadanych określonego załącznika wiadomości.