Metadaten zu einem Nachrichtenanhang abrufen

In dieser Anleitung wird erläutert, wie Sie die Methode get für die Ressource Media der Google Chat API verwenden, um Metadaten zu einem Nachrichtenanhang abzurufen. Die Antwort ist eine Instanz der Ressource Attachment.

Wenn der Nutzer eine Nachricht an Ihre App sendet, löst Google Chat ein MESSAGE-Interaktionsereignis aus. Das von Ihrer App empfangene Interaktionsereignis enthält einen Anfragetext. Dabei handelt es sich um die JSON-Nutzlast, die das Interaktionsereignis darstellt, einschließlich etwaiger Anhänge. Die Daten im Anhang unterscheiden sich je nachdem, ob es sich um hochgeladene Inhalte (eine lokale Datei) oder um eine in Drive gespeicherte Datei handelt. Die Ressource Media steht für eine in Google Chat hochgeladene Datei, z. B. Bilder, Videos und Dokumente. Die Ressource Attachment stellt eine Medieninstanz – eine Datei – dar, die an eine Nachricht angehängt ist. Die Ressource Attachment enthält die Metadaten zum Anhang, z. B. den Speicherort.

Voraussetzungen

Python

  • Python 3.6 oder höher
  • Das Paketverwaltungstool pip

  • Die aktuellen Google-Clientbibliotheken für Python. Führen Sie den folgenden Befehl in der Befehlszeile aus, um sie zu installieren oder zu aktualisieren:

    pip3 install --upgrade google-api-python-client google-auth-oauthlib google-auth
  • Ein Google Cloud-Projekt, in dem die Google Chat API aktiviert und konfiguriert ist. Eine entsprechende Anleitung finden Sie unter Google Chat-App erstellen.

  • Für die Chat-Anwendung konfigurierte Autorisierung. Um eine Nachricht zu erhalten, ist eine App-Authentifizierung mit dem Autorisierungsbereich chat.bot erforderlich.

Nachrichtenanhang abrufen

Übergeben Sie in Ihrer Anfrage Folgendes, um asynchron Metadaten zu einem Nachrichtenanhang in Google Chat abzurufen:

  • Geben Sie den Autorisierungsbereich chat.bot an.
  • Rufen Sie die Methode get für die Ressource Attachment auf.
  • Übergeben Sie den name des Nachrichtenanhangs.

So rufen Sie Metadaten zu einem Nachrichtenanhang ab:

Python

  1. Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen chat_get_message_attachment.py.

  2. Fügen Sie den folgenden Code in chat_get_message_attachment.py ein:

    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. Ersetzen Sie im Code spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT durch den Namen des Nachrichtenanhangs.

  4. Erstellen Sie das Beispiel in Ihrem Arbeitsverzeichnis und führen Sie es aus:

    python3 chat_get_message_attachment.py

Die Chat API gibt eine Instanz von Attachment zurück, die die Metadaten zum angegebenen Nachrichtenanhang beschreibt.