Method: spaces.delete
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
刪除具名空間。一律執行連鎖刪除作業,也就是一併刪除聊天室的子項資源,例如聊天室中發布的訊息和聊天室成員。如需範例,請參閱「刪除聊天室」。
支援下列類型的驗證:
應用程式驗證 (須經管理員核准),授權範圍如下:
https://www.googleapis.com/auth/chat.app.delete
(僅限應用程式建立的聊天室)
使用者驗證,並使用下列其中一個授權範圍:
https://www.googleapis.com/auth/chat.delete
https://www.googleapis.com/auth/chat.import
(僅限匯入模式聊天室)
- 使用者驗證會在管理員帳戶通過驗證時授予管理員權限,
useAdminAccess
為 true
,且使用下列授權範圍:
https://www.googleapis.com/auth/chat.admin.delete
HTTP 要求
DELETE https://chat.googleapis.com/v1/{name=spaces/*}
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
name |
string
必要欄位。要刪除的聊天室資源名稱。 格式:spaces/{space}
|
查詢參數
參數 |
useAdminAccess |
boolean
(選用步驟) 時,這個方法會使用使用者的 Google Workspace 管理員權限執行。true 通話使用者必須是具備「管理即時通訊和聊天室對話」權限的 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
詳情請參閱授權指南。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-29 (世界標準時間)。
[null,null,["上次更新時間:2025-07-29 (世界標準時間)。"],[[["\u003cp\u003eThis request permanently deletes a space and all its child resources, including messages and memberships.\u003c/p\u003e\n"],["\u003cp\u003eAuthentication can be performed using app authentication (with administrator approval) or user authentication (including with administrator privileges using \u003ccode\u003euseAdminAccess\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the space's resource name in the URL path and can optionally use the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter for administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, such as \u003ccode\u003echat.app.delete\u003c/code\u003e or \u003ccode\u003echat.admin.delete\u003c/code\u003e, as detailed in the Authorization guide.\u003c/p\u003e\n"]]],["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"],null,["# Method: spaces.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nDeletes a named space. Always performs a cascading delete, which means that the space's child resources---like messages posted in the space and memberships in the space---are also deleted. For an example, see [Delete a space](https://developers.google.com/workspace/chat/delete-spaces).\n\nSupports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize):\n\n- [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) and the authorization scope:\n\n - `https://www.googleapis.com/auth/chat.app.delete` (only in spaces the app created)\n- [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes:\n\n - `https://www.googleapis.com/auth/chat.delete`\n - `https://www.googleapis.com/auth/chat.import` (import mode spaces only)\n - User authentication grants administrator privileges when an administrator account authenticates, `useAdminAccess` is `true`, and the following authorization scope is used:\n - `https://www.googleapis.com/auth/chat.admin.delete`\n\n### HTTP request\n\n`DELETE https://chat.googleapis.com/v1/{name=spaces/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|-----------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the space to delete. Format: `spaces/{space}` |\n\n### Query parameters\n\n| Parameters ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `useAdminAccess` | `boolean` Optional. When `true`, the method runs using the user's Google Workspace administrator privileges. The calling user must be a Google Workspace administrator with the [manage chat and spaces conversations privilege](https://support.google.com/a/answer/13369245). Requires the `chat.admin.delete` [OAuth 2.0 scope](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes). |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.app.delete`\n- `https://www.googleapis.com/auth/chat.admin.delete`\n- `https://www.googleapis.com/auth/chat.import`\n- `https://www.googleapis.com/auth/chat.delete`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]