Method: spaces.messages.delete

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

Erfordert eine Authentifizierung. Unterstützt die App-Authentifizierung und die Nutzerauthentifizierung. Bei Verwendung 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, die Sie löschen möchten, im Format spaces/*/messages/*

Beispiel: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

Abfrageparameter

Parameter
force

boolean

Beim Löschen einer Nachricht mit true werden auch die Unterhaltungsthreads für Antworten gelöscht. Wenn false und eine Nachricht Unterhaltungsthreads für Antworten enthält, schlägt das Löschen fehl.

Gilt nur für die Authentifizierung als Nutzer. Hat keine Auswirkungen auf die Authentifizierung als Chat-App.

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.