Diese Seite wurde von der Cloud Translation API übersetzt.

Metadaten zu einem Nachrichtenanhang abrufen

In diesem Leitfaden wird beschrieben, wie Sie die Methode get() für die Ressource Attachment der Google Chat API verwenden, um Metadaten zu einem Nachrichtenanhang abzurufen. Die Antwort ist eine Instanz der Attachment-Ressource.

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

Vorbereitung

Node.js

Ein Google Workspace-Konto für Unternehmen oder Organisationen mit Zugriff auf Google Chat.

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, Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Google Cloud-Clientbibliothek für Node.js.
- Anmeldedaten für ein Dienstkonto erstellen Wenn Sie das Beispiel in dieser Anleitung ausführen möchten, speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen credentials.json in Ihrem lokalen Verzeichnis.
Wählen Sie einen Autorisierungsbereich aus, der die App-Authentifizierung unterstützt.

Anhang einer Nachricht abrufen

Wenn Sie asynchron Metadaten zu einem Nachrichtenanhang in Google Chat abrufen möchten, geben Sie Folgendes in Ihrer Anfrage an:

Geben Sie den Autorisierungsbereich chat.bot an.
Rufen Sie die Methode GetAttachment() auf und übergeben Sie die name des Anhangs der Nachricht.

So rufen Sie Metadaten zu einem Nachrichtenanhang ab:

Node.js

chat/client-libraries/cloud/get-attachment-app-cred.js

Auf GitHub ansehen

import {createClientWithAppCredentials} from './authentication-utils.js';

// This sample shows how to get attachment metadata with app credential
async function main() {
  // Create a client
  const chatClient = createClientWithAppCredentials();

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME, MESSAGE_NAME, and ATTACHMENT_NAME here
    name: 'spaces/SPACE_NAME/messages/MESSAGE_NAME/attachments/ATTACHMENT_NAME'
  };

  // Make the request
  const response = await chatClient.getAttachment(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Ersetzen Sie zum Ausführen dieses Beispiels spaces/SPACE_NAME/messages/ MESSAGE_NAME/attachments/ATTACHMENT_NAME durch den Namen des Anhangs der Nachricht.

Die Chat API gibt eine Instanz von Attachment zurück, die die Metadaten zum angegebenen Anhang der Nachricht enthält.