In diesem Leitfaden wird beschrieben, wie Sie die Methode update()
für die Message
-Ressource der Google Chat API verwenden, um eine Text- oder Kartennachricht in einem Gruppenbereich zu aktualisieren. Aktualisieren Sie eine Nachricht, um Nachrichtenattribute wie den Inhalt oder den Inhalt einer Karte zu ändern. Sie können auch eine Textnachricht
oder eine Karte an eine SMS anhängen.
In der Chat API wird eine Chatnachricht durch das
Message
-Ressource
Chat-Nutzer können zwar nur Nachrichten senden, die Text enthalten,
Chat-Apps können viele andere Messaging-Funktionen nutzen, darunter
Anzeige statischer oder interaktiver Benutzeroberflächen, das Erfassen von Informationen
und Nachrichten privat zu übermitteln. 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 Google 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.
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 Python Cloud-Clientbibliothek
- 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 den Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App authentifizieren möchten.
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, und eine Beschreibung der Chat App.
- Installieren Sie die Java 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.
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 Nutzer oder die App-Authentifizierung. Erstellen Sie Anmeldedaten für ein Dienstkonto, um sich als Chat-App zu authentifizieren. 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.
Nachricht im Namen eines Nutzers aktualisieren
Bei der Nutzerauthentifizierung kann nur der Text einer Nachricht aktualisiert werden.
Wenn Sie eine Nachricht mit Nutzerauthentifizierung aktualisieren möchten, geben Sie Folgendes in Ihrer Anfrage an:
- Geben Sie den Autorisierungsbereich
chat.messages
an. - Rufen Sie die Methode
UpdateMessage()
auf. - Übergeben Sie
message
als Instanz vonMessage
Dabei gilt:- Das Feld „
name
“, das für die zu aktualisierende Nachricht festgelegt ist und die die ID des Gruppenbereichs enthält und eine Nachrichten-ID. - Das Feld
text
ist mit dem neuen Text festgelegt.
- Das Feld „
- Übergeben Sie
updateMask
mit dem Werttext
.
Wenn es sich bei der aktualisierten Nachricht um eine Kartennachricht handelt, wird der Text vor die Karten eingefügt, die weiterhin angezeigt werden.
So aktualisieren Sie eine Nachricht oder fügen Sie einer Kartennachricht mit Nutzerauthentifizierung eine SMS vor:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:
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 finden die ID im Antworttext, der nach dem Erstellen eines asynchron mit der Chat API oder mit dem benutzerdefinierter Name der Nachricht bei der Erstellung zugewiesen ist.
Die Chat API gibt eine Instanz von
Message
der die aktualisierte Nachricht enthält.
Nachricht in der Chat App aktualisieren
Mit der App-Authentifizierung können sowohl der Text als auch die Karten einer Nachricht aktualisiert werden.
Um eine Nachricht mit App-Authentifizierung zu aktualisieren, übergeben Sie in Ihrer Anfrage Folgendes:
- Geben Sie den Autorisierungsbereich für
chat.bot
an. - Rufen Sie die Methode
UpdateMessage()
auf. - Übergeben Sie
message
als Instanz vonMessage
Dabei gilt:- Das Feld „
name
“, das für die zu aktualisierende Nachricht festgelegt ist und die die ID des Gruppenbereichs enthält und eine Nachrichten-ID. - Das Feld
text
, das mit dem neuen Text festgelegt ist, wenn es aktualisiert werden muss. - Das mit den neuen Karten festgelegte Feld
cardsV2
, wenn diese aktualisiert werden müssen.
- Das Feld „
- Übergeben Sie
updateMask
mit der Liste der Felder, um z. B.text
zu aktualisieren, undcardsV2
Wenn die aktualisierte Nachricht Kartennachricht und der Text aktualisiert wird, wird der aktualisierte Text den Karten vorangestellt, die weiterhin angezeigt werden. Wenn die aktualisierte Nachricht SMS und Karten aktualisiert werden, hängen die aktualisierten Karten an den Text an (der sich Display).
So aktualisieren Sie den Text und die Karten einer Nachricht mit App-Authentifizierung:
Node.js
Python
Java
Apps Script
Ersetzen Sie zum Ausführen dieses Beispiels Folgendes:
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 finden die ID im Antworttext, der nach dem Erstellen eines asynchron mit der Chat API oder mit dem benutzerdefinierter Name der Nachricht bei der Erstellung zugewiesen ist.
Die Chat API gibt eine Instanz von Message
zurück, die Details zur aktualisierten Nachricht enthält.
Weitere Informationen
- Nachricht formatieren
- Nachricht löschen
- Details zu einer Nachricht abrufen
- Nachrichten in einem Gruppenbereich auflisten
- Nachricht senden: