In diesem Leitfaden wird beschrieben, wie Sie die Methode delete()
für die Message
-Ressource der Google Chat API verwenden, um eine Text- oder Karten-Nachricht zu löschen.
In der Chat API wird eine Chat-Nachricht durch die Ressource Message
dargestellt.
Während Chat-Nutzer nur Nachrichten mit Text senden können, können Chat-Apps viele andere Messaging-Funktionen nutzen, darunter das Anzeigen statischer oder interaktiver Benutzeroberflächen, das Erfassen von Informationen von Nutzern und das private Senden von Nachrichten. Weitere Informationen zu den Messaging-Funktionen, die für die Chat API verfügbar sind, finden Sie unter Google Chat-Nachrichten – Übersicht.
Mit der App-Authentifizierung können Sie diese Methode verwenden, um eine Nachricht zu löschen, die von der Chat-App gesendet wurde. Bei der Nutzerauthentifizierung können Sie mit dieser Methode eine Nachricht löschen, die der authentifizierte Nutzer gesendet hat. Wenn der Nutzer Administrator des Gruppenbereichs ist, können Sie möglicherweise auch Nachrichten löschen, die von anderen Mitgliedern des Gruppenbereichs gesendet wurden. Weitere Informationen finden Sie unter Die Rolle als Administrator eines Gruppenbereichs.
Vorbereitung
Node.js
- Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen
- OAuth-Zustimmungsbildschirm konfigurieren
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, einem 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
credentials.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 authentifizieren möchten.
Python
- Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen
- OAuth-Zustimmungsbildschirm konfigurieren
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, einem 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
credentials.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 authentifizieren möchten.
Java
- Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen
- OAuth-Zustimmungsbildschirm konfigurieren
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, einem Symbol und einer Beschreibung für Ihre Chat-App.
- Installieren Sie die Cloud-Clientbibliothek für Java.
- 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
credentials.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 authentifizieren möchten.
Apps Script
- Ein Google Workspace-Konto für Unternehmen mit Zugriff auf Google Chat.
- Umgebung einrichten:
- Google Cloud-Projekt erstellen
- OAuth-Zustimmungsbildschirm konfigurieren
- Aktivieren und konfigurieren Sie die Google Chat API mit einem Namen, einem Symbol und einer Beschreibung für Ihre Chat-App.
- Erstellen Sie ein eigenständiges Apps Script-Projekt und aktivieren Sie den Advanced Chat Service.
- In diesem Leitfaden müssen Sie entweder die Nutzer- oder die App-Authentifizierung verwenden. Wenn Sie sich als Chat-App authentifizieren möchten, 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 authentifizieren möchten.
Nachricht mit Nutzerauthentifizierung löschen
Wenn Sie eine Nachricht mit Nutzerauthentifizierung löschen möchten, übergeben Sie Folgendes in Ihrer Anfrage:
- Geben Sie den
chat.messages
-Autorisierungsbereich an. - Rufen Sie die Methode
DeleteMessage()
auf. - Setzen Sie
name
auf den Ressourcenname der zu löschenden Nachricht.
Im folgenden Beispiel wird eine Nachricht mit Nutzerauthentifizierung gelöscht:
Node.js
Python
Java
Apps Script
Um dieses Beispiel auszuführen, ersetzen Sie Folgendes:
SPACE_NAME
: Die ID aus demname
des Bereichs. Sie können die ID abrufen, indem Sie die MethodeListSpaces()
aufrufen oder die URL des Bereichs verwenden.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 oder mit dem benutzerdefinierten Namen zurückgegeben wird, der der Nachricht bei der Erstellung zugewiesen wurde.
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer. Das bedeutet, dass die Nachricht gelöscht wurde.
Nachricht mit App-Authentifizierung löschen
Wenn Sie eine Nachricht mit App-Authentifizierung löschen möchten, übergeben Sie Folgendes in Ihrer Anfrage:
- Geben Sie den
chat.bot
-Autorisierungsbereich an. - Rufen Sie die Methode
DeleteMessage()
auf. - Setzen Sie
name
auf den Ressourcenname der zu löschenden Nachricht.
Im folgenden Beispiel wird eine Nachricht mit App-Authentifizierung gelöscht:
Node.js
Python
Java
Apps Script
Um dieses Beispiel auszuführen, ersetzen Sie Folgendes:
SPACE_NAME
: Die ID aus demname
des Bereichs. Sie können die ID abrufen, indem Sie die MethodeListSpaces()
aufrufen oder die URL des Bereichs verwenden.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 oder mit dem benutzerdefinierten Namen zurückgegeben wird, der der Nachricht bei der Erstellung zugewiesen wurde.
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer. Das bedeutet, dass die Nachricht gelöscht wurde.
Weitere Informationen
- Nachricht formatieren
- Details zu einer Nachricht abrufen
- Nachrichten in einem Gruppenbereich auflisten
- Nachricht aktualisieren
- Nachricht senden: