Method: spaces.delete
名前付きスペースを削除します。常にカスケード削除を実行します。つまり、スペースの子リソース(スペースに投稿されたメッセージやスペースのメンバーシップなど)も削除されます。例については、Space を削除するをご覧ください。
次のタイプの認証をサポートしています。
HTTP リクエスト
DELETE https://chat.googleapis.com/v1/{name=spaces/*}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
name |
string
必須。削除するスペースのリソース名。 形式: spaces/{space}
|
クエリ パラメータ
パラメータ |
useAdminAccess |
boolean
省略可。true の場合、メソッドはユーザーの Google Workspace 管理者権限を使用して実行されます。 呼び出し元のユーザーは、Chat とスペースの会話の管理権限を持つ Google Workspace 管理者である必要があります。 chat.admin.delete OAuth 2.0 スコープが必要です。
|
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文は空の JSON オブジェクトになります。
認可スコープ
以下のいずれかの OAuth スコープが必要です。
https://www.googleapis.com/auth/chat.app.delete
https://www.googleapis.com/auth/chat.admin.delete
https://www.googleapis.com/auth/chat.import
https://www.googleapis.com/auth/chat.delete
詳しくは、認可ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-02-27 UTC。
[null,null,["最終更新日 2025-02-27 UTC。"],[[["This request permanently deletes a space and all its child resources, including messages and memberships."],["Authentication can be performed using app authentication (with administrator approval) or user authentication (including with administrator privileges using `useAdminAccess`)."],["The request requires the space's resource name in the URL path and can optionally use the `useAdminAccess` query parameter for administrator privileges."],["Requires specific OAuth scopes for authorization, such as `chat.app.delete` or `chat.admin.delete`, as detailed in the Authorization guide."]]],["This describes how to delete a named space using the Chat API, including its child resources. A `DELETE` request is sent to `https://chat.googleapis.com/v1/{name=spaces/*}`. The `name` path parameter specifies the space to delete. The `useAdminAccess` query parameter enables administrator privileges, which requires the `chat.admin.delete` OAuth scope and specific admin rights. The request body must be empty, and a successful deletion returns an empty JSON object. Authorization requires specific OAuth scopes.\n"]]