In diesem Leitfaden wird erläutert, wie Sie die Methode get()
für die Ressource Message
der Google Chat API verwenden, um Details zu einer Text- oder Kartennachricht zurückzugeben.
In der Chat API wird eine Chatnachricht durch die Ressource Message
dargestellt.
Während Google Chat-Nutzer nur Nachrichten senden können, die Text enthalten, können Chat-Apps viele weitere Messaging-Funktionen nutzen, z. B. statische oder interaktive Benutzeroberflächen anzeigen, Informationen von Nutzern erheben und Nachrichten privat senden. Weitere Informationen zu den Messaging-Funktionen, die für die Chat API verfügbar sind, finden Sie unter Google Chat-Nachrichten – Übersicht.
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 Cloud-Clientbibliothek für Node.js.
- Erstellen Sie Anmeldedaten für den Zugriff, je nachdem, wie Sie sich in Ihrer Google Chat API-Anfrage authentifizieren möchten:
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis. - Wenn Sie sich als Chat-App authentifizieren möchten, erstellen Sie Anmeldedaten für das Dienstkonto und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
.
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- Wählen Sie den Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App authentifizieren möchten.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Chat-App hinzu.
Python
- 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 Cloud-Clientbibliothek für Python.
- Erstellen Sie Anmeldedaten für den Zugriff, je nachdem, wie Sie sich in Ihrer Google Chat API-Anfrage authentifizieren möchten:
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis. - Wenn Sie sich als Chat-App authentifizieren möchten, erstellen Sie Anmeldedaten für das Dienstkonto und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
.
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- Wählen Sie den Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App authentifizieren möchten.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Chat-App hinzu.
Java
- 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 Java-Cloud-Clientbibliothek.
- Erstellen Sie Anmeldedaten für den Zugriff, je nachdem, wie Sie sich in Ihrer Google Chat API-Anfrage authentifizieren möchten:
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihrem lokalen Verzeichnis. - Wenn Sie sich als Chat-App authentifizieren möchten, erstellen Sie Anmeldedaten für das Dienstkonto und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
.
- Wenn Sie sich als Chat-Nutzer authentifizieren möchten, erstellen Sie Anmeldedaten für die OAuth-Client-ID und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- Wählen Sie den Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App authentifizieren möchten.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Chat-App hinzu.
Apps Script
- 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.
- Erstellen Sie ein eigenständiges Apps Script-Projekt und aktivieren Sie den erweiterten Chatdienst.
- In diesem Leitfaden müssen Sie entweder die Nutzer- oder die App-Authentifizierung verwenden. Erstellen Sie Anmeldedaten für ein Dienstkonto, um sich als Chat-App zu authentifizieren. Eine Anleitung dazu finden Sie unter Als Google Chat-App authentifizieren und autorisieren.
- Wählen Sie den Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App authentifizieren möchten.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Chat-App hinzu.
Nachricht mit Nutzerauthentifizierung erhalten
Wenn Sie Details zu einer Nachricht mit Nutzerauthentifizierung abrufen möchten, geben Sie Folgendes in Ihrer Anfrage an:
- Geben Sie den Autorisierungsbereich
chat.messages.readonly
oderchat.messages
an. - Rufen Sie die Methode
GetMessage()
auf. - Legen Sie
name
auf den Ressourcennamen der Nachricht fest, die abgerufen werden soll.
Im folgenden Beispiel wird eine Nachricht mit Nutzerauthentifizierung abgerufen:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:
SPACE_NAME
: die ID aus dername
des Gruppenbereichs. Sie können die ID durch Aufrufen der MethodeListSpaces()
oder über die URL des Gruppenbereichs abrufen.MESSAGE_NAME
: die ID aus demname
der Nachricht. Sie können die ID aus dem Antworttext abrufen, der nach dem asynchronen Erstellen einer Nachricht mit der Chat API zurückgegeben wird, oder über den benutzerdefinierten Namen, der der Nachricht beim Erstellen zugewiesen wurde.
Die Chat API gibt eine Instanz von Message
zurück, die Details zur angegebenen Nachricht enthält.
Nachricht mit App-Authentifizierung erhalten
Wenn Sie Details zu einer Nachricht mit App-Authentifizierung abrufen möchten, geben Sie Folgendes in Ihrer Anfrage an:
- Geben Sie den Autorisierungsbereich für
chat.bot
an. - Rufen Sie die Methode
GetMessage()
auf. - Legen Sie
name
auf den Ressourcennamen der Nachricht fest, die abgerufen werden soll.
Im folgenden Beispiel wird eine Nachricht mit App-Authentifizierung abgerufen:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:
SPACE_NAME
: die ID aus dername
des Gruppenbereichs. Sie können die ID durch Aufrufen der MethodeListSpaces()
oder über die URL des Gruppenbereichs abrufen.MESSAGE_NAME
: die ID aus demname
der Nachricht. Sie können die ID aus dem Antworttext abrufen, der nach dem asynchronen Erstellen einer Nachricht mit der Chat API zurückgegeben wird, oder über den benutzerdefinierten Namen, der der Nachricht beim Erstellen zugewiesen wurde.
Die Chat API gibt eine Instanz von Message
zurück, die Details zur angegebenen Nachricht enthält.
Weitere Informationen
- Nachricht formatieren
- Nachricht löschen
- Nachrichten in einem Gruppenbereich auflisten
- Nachricht aktualisieren
- Nachricht senden: