In diesem Leitfaden wird die Verwendung des
get()
für die Ressource Message
der Google Chat API, um Details zu einer
Text- oder Kartennachricht.
In der Chat API wird eine Chatnachricht durch das
Message
-Ressource
Während Google Chat-Nutzer nur Nachrichten senden können, die Text enthalten, können Chat-Apps viele weitere Messaging-Funktionen nutzen, z. B. das Anzeigen statischer oder interaktiver Benutzeroberflächen, das Erfassen von Informationen von Nutzern und die private Zustellung von Nachrichten. Weitere Informationen zur Nachrichtenfunktion
die für die Chat API zur Verfügung stehen, finden Sie in der
Nachrichten in Google Chat
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 Node.js Cloud-Clientbibliothek
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
- 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. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten 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 Google Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Google Chat-App hinzu.
Python
- Unternehmen Google Workspace-Konto 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.
- Anmeldedaten für den Zugriff basierend auf der Authentifizierung in der Google Chat API erstellen
Anfrage:
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales Verzeichnis. - So authentifizieren Sie sich als Chat-App:
Dienstkonto erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
credentials.json
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Google Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Google Chat-App hinzu.
Java
- Unternehmen Google Workspace-Konto 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:
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
client_secrets.json
in Ihr lokales 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
.
- So authentifizieren Sie sich als Chat-Nutzer:
OAuth-Client-ID erstellen
Anmeldedaten und speichern Sie die Anmeldedaten als JSON-Datei mit dem Namen
- Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. So authentifizieren Sie sich als der Chat-App fügen Sie die Chat-App mit dem Gruppenbereich
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, und eine Beschreibung der Chat App.
- Eigenständiges Apps Script-Projekt erstellen und aktivieren Sie den erweiterten Chatdienst.
- In diesem Leitfaden müssen Sie entweder die Nutzer- oder die App-Authentifizierung verwenden. Um sich als die Chat-App zu authentifizieren, erstellen Sie Dienstkonto-Anmeldedaten Eine Anleitung dazu finden Sie unter Authentifizierung und Autorisierung als Google Chat App
- Wählen Sie einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
- Ein Google Chat-Bereich, in dem der authentifizierte Nutzer oder die anrufende Chat-App Mitglied ist. Wenn Sie sich als Google Chat-App authentifizieren möchten, fügen Sie den Gruppenbereich die Google Chat-App hinzu.
Nachricht mit Nutzerauthentifizierung abrufen
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 abzurufenden Nachricht fest.
Im folgenden Beispiel wird eine Nachricht mit Nutzerauthentifizierung abgerufen:
Node.js
Python
Java
Apps Script
Ersetzen Sie Folgendes, um dieses Beispiel auszuführen:
SPACE_NAME
: die ID aus demname
Sie erhalten die ID durch Aufrufen derListSpaces()
oder anhand der URL des Gruppenbereichs erfolgen.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
die die jeweilige Nachricht enthält.
Nachricht mit App-Authentifizierung erhalten
Um Details zu einer Nachricht mit App-Authentifizierung Übergeben Sie in Ihrer Anfrage Folgendes:
- Geben Sie den Autorisierungsbereich
chat.bot
an. - Rufen Sie die Methode
GetMessage()
auf. - Legen Sie
name
auf den Ressourcennamen der abzurufenden Nachricht fest.
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 demname
Sie können die ID durch Aufrufen der MethodeListSpaces()
oder aus der URL des Gruppenbereichs abrufen.MESSAGE_NAME
: die ID aus dername
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: