Method: spaces.messages.delete

Löscht eine Nachricht. Ein Beispiel finden Sie unter Nachricht löschen.

Unterstützt die folgenden Authentifizierungstypen:

  • App-Authentifizierung mit dem Autorisierungsbereich:

    • https://www.googleapis.com/auth/chat.bot

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)

Bei der App-Authentifizierung können mit Anfragen nur Nachrichten gelöscht werden, die von der anrufenden Chat-App erstellt wurden.

HTTP-Anfrage

DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname der Nachricht.

Format: spaces/{space}/messages/{message}

Wenn Sie eine benutzerdefinierte ID für Ihre Nachricht festgelegt haben, können Sie den Wert aus dem Feld clientAssignedMessageId für {message} verwenden. Weitere Informationen

Abfrageparameter

Parameter
force

boolean

Optional. Wenn true aktiviert ist, werden beim Löschen einer Nachricht auch die Antworten im Thread gelöscht. Wenn false und eine Nachricht Antworten in einem Thread enthält, schlägt das Löschen fehl.

Gilt nur bei der Authentifizierung als Nutzer. Hat keine Auswirkungen bei der Authentifizierung als Chat-App.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.