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 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

Parameters
name

string

Erforderlich. Ressourcenname der Nachricht.

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

Wenn du eine benutzerdefinierte ID für deine Nachricht festgelegt hast, kannst du den Wert aus dem Feld clientAssignedMessageId für {message} verwenden. Weitere Informationen finden Sie im Hilfeartikel Nachrichten benennen.

Abfrageparameter

Parameters
force

boolean

Bei der Einstellung true werden beim Löschen einer Nachricht auch die zugehörigen Antwortthreads gelöscht. Wenn false und eine Nachricht Unterhaltungsthreads für Antworten enthält, schlägt das Löschen fehl.

Gilt nur bei der Authentifizierung als Nutzer. Dies hat keine Auswirkungen bei der 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.