Method: spaces.messages.delete

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

Unterstützt die folgenden Authentifizierungstypen:

Bei der App-Authentifizierung können Anfragen nur Nachrichten löschen, die von der aufrufenden 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 finden Sie im Hilfeartikel Nachrichten benennen.

Abfrageparameter

Parameter
force

boolean

Optional. Wenn true ausgewählt 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, wenn Sie sich als Chat-App authentifizieren.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

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.