Method: spaces.messages.delete

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

次のタイプの認証をサポートしています。

  • 認可スコープを使用したアプリ認証:

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

  • 次のいずれかの認可スコープを使用したユーザー認証:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import（インポート モードのスペースのみ）

アプリ認証を使用する場合、リクエストで削除できるのは、呼び出し元の 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 アプリとして認証する場合は効果がありません。

リクエストの本文

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

レスポンスの本文

成功した場合、レスポンスの本文は空の JSON オブジェクトになります。

認可スコープ

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

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

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