In diesem Leitfaden wird die Verwendung des
delete()
Methode für die Ressource Message
der Google Chat API, um einen Text oder eine Karte zu löschen
.
In der Chat API wird eine Chatnachricht durch die Ressource Message
dargestellt.
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 zu den Messaging-Funktionen, die für die Chat API verfügbar sind, finden Sie unter Google Chat-Nachrichten – Übersicht.
Bei der App-Authentifizierung können Sie mit dieser Methode eine Nachricht löschen, die über die Chat-App gesendet wurde. Bei der Nutzerauthentifizierung können Sie mit dieser Methode eine Nachricht löschen, die der authentifizierte Nutzer gesendet hat. Wenn wenn der Nutzer Administrator des Gruppenbereichs ist, haben Sie möglicherweise auch die Möglichkeit, Nachricht, die andere Mitglieder des Gruppenbereichs gesendet haben. Weitere Informationen finden Sie unter Die Rolle als Administrator eines Gruppenbereichs.
Vorbereitung
Node.js
- 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, und eine Beschreibung der Chat App.
- Installieren Sie die Google Cloud-Clientbibliothek für Node.js.
- 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.
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, und eine Beschreibung der 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. - 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 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.
- 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 einen Autorisierungsbereich aus, je nachdem, ob Sie sich als Nutzer oder als Chat-App.
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.
- 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. 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.
Nachrichten mit Nutzerauthentifizierung löschen
Wenn Sie eine Nachricht mit Nutzerauthentifizierung löschen möchten, geben Sie Folgendes in Ihrer Anfrage an:
- Geben Sie den Autorisierungsbereich
chat.messages
an. - Rufen Sie die Methode
DeleteMessage()
auf. - Legen Sie für
name
den Ressourcennamen der zu löschenden Nachricht fest.
Im folgenden Beispiel wird eine Nachricht mit Nutzerauthentifizierung:
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 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.
Wenn der Vorgang erfolgreich war, ist der Antworttext leer, was darauf hinweist, dass die Nachricht gelöscht.
Nachricht mit App-Authentifizierung löschen
So löschen Sie eine Nachricht mit App-Authentifizierung, übergeben Sie den Folgendes in Ihrer Anfrage angeben:
- Geben Sie den Autorisierungsbereich
chat.bot
an. - Rufen Sie die Methode
DeleteMessage()
auf. - Legen Sie
name
auf den Ressourcennamen der zu löschenden Nachricht fest.
Im folgenden Beispiel wird eine Nachricht mit App-Authentifizierung:
Node.js
Python
Java
Apps Script
Ersetzen Sie Folgendes, um dieses Beispiel auszuführen:
SPACE_NAME
: die ID aus dername
des Gruppenbereichs. Sie erhalten die ID durch Aufrufen derListSpaces()
oder anhand der URL des Gruppenbereichs erfolgen.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.
Wenn der Vorgang erfolgreich war, ist der Antworttext leer.
Weitere Informationen
- Nachricht formatieren
- Details zu einer Nachricht abrufen
- Nachrichten in einem Gruppenbereich auflisten
- Nachricht aktualisieren
- Nachricht senden: