Method: spaces.messages.delete

メッセージを削除します。例については、メッセージを削除するをご覧ください。

認証が必要です。アプリの認証とユーザー認証をサポートします。アプリの認証を使用する場合、リクエストで削除できるのは、呼び出し元の Chat アプリによって作成されたメッセージのみです。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
name

string

必須。メッセージのリソース名。

形式: spaces/{space}/messages/{message}

メッセージにカスタム ID を設定している場合は、{message} の clientAssignedMessageId フィールドの値を使用できます。詳しくは、メッセージに名前を付けるをご覧ください。

クエリ パラメータ

パラメータ
force

boolean

true の場合、メッセージを削除するとスレッド返信も削除されます。false の場合、メッセージがスレッド形式の返信である場合、削除は失敗します。

ユーザーとして認証する場合にのみ適用されます。Chat アプリとして認証する場合は適用されません。

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

承認スコープ

次の OAuth スコープのいずれかが必要です。

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

詳しくは、承認ガイドをご覧ください。