In diesem Leitfaden wird erläutert, wie Sie die Methode get
für die Ressource Media
des
Google Chat API, um Metadaten zu einem Nachrichtenanhang abzurufen. Die Antwort ist ein
Instanz von
Attachment
-Ressource
Wenn der Nutzer eine Nachricht an Ihre App sendet, sendet Google Chat eine
MESSAGE
-Interaktionsereignis.
Das von Ihrer App empfangene Interaktionsereignis enthält einen Anfragetext, also den
JSON-Nutzlast, die das Interaktionsereignis darstellt, einschließlich etwaiger Anhänge. Die
Daten im Anhang unterschiedlich sind, je nachdem, ob der Anhang
hochgeladene Inhalte (eine lokale Datei) oder eine in Google Drive gespeicherte Datei. Die
Media
-Ressource
steht für eine in Google Chat hochgeladene Datei, z. B. Bilder, Videos und Dokumente.
Die
Attachment
-Ressource
steht für eine Instanz von Medien – eine Datei –, die an eine Nachricht angehängt ist. Das Attachment
Ressource die Metadaten zum Anhang enthält, z. B.
wo sie gespeichert wird.
Vorbereitung
Python
- Unternehmen Google Workspace-Konto mit Zugriff auf Google Chat:
- Python 3.6 oder höher
- Paketverwaltungstool pip
- Die neuesten Google-Clientbibliotheken So installieren oder aktualisieren Sie sie:
Führen Sie in der Befehlszeile den folgenden Befehl aus:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- Richten Sie Ihre Umgebung ein:
- Google Cloud-Projekt erstellen
- Konfigurieren Sie den OAuth-Zustimmungsbildschirm.
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, und eine Beschreibung der Chat App.
-
Erstellen Sie OAuth-Client-ID-Anmeldedaten für eine Desktopanwendung. Um das Beispiel in diesem
sollten Sie die Anmeldedaten als JSON-Datei (
client_secrets.json
) in Ihrem lokales Verzeichnis.
- Wählen Sie einen Autorisierungsbereich aus, der die Nutzerauthentifizierung unterstützt.
Nachrichtenanhang abrufen
Um Metadaten zu einem Nachrichtenanhang in Google Chat asynchron abzurufen, übergeben Sie Folgendes in Ihrer Anfrage angeben:
- Geben Sie den Autorisierungsbereich
chat.bot
an. - Rufen Sie die Methode
get
-Methode amAttachment
-Ressource, - Übergeben Sie die
name
des Nachrichtenanhangs.
So rufen Sie Metadaten zu einem Nachrichtenanhang ab:
Python
- Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen
chat_get_message_attachment.py
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)
Ersetzen Sie im Code
spaces/SPACE/messages/MESSAGE/attachments/ATTACHMENT
durch den Namen des Nachrichtenanhangs.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
enthält die Metadaten zum angegebenen Nachrichtenanhang.