Method: spaces.delete
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מחיקת מרחב עם שם. תמיד מבצע מחיקה מדורגת, כלומר גם משאבי הצאצא של המרחב – כמו הודעות שפורסמו במרחב והחברות במרחב – נמחקים. דוגמה מופיעה במאמר מחיקת מרחב.
יש תמיכה בסוגי האימות הבאים:
בקשת HTTP
DELETE https://chat.googleapis.com/v1/{name=spaces/*}
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. שם המשאב של המרחב שרוצים למחוק. פורמט: spaces/{space}
|
פרמטרים של שאילתה
| פרמטרים |
useAdminAccess |
boolean
אופציונלי. כשמגדירים את true, השיטה מופעלת באמצעות הרשאות האדמין של המשתמש ב-Google Workspace. המשתמש שמבצע את השיחה צריך להיות אדמין ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים. נדרש chat.admin.delete היקף הרשאות OAuth 2.0.
|
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט JSON ריק.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/chat.app.deletehttps://www.googleapis.com/auth/chat.admin.deletehttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.delete
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-29 (שעון UTC)."],[[["\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)."]]
