Method: spaces.delete
מחיקה של מרחב משותף בעל שם. תמיד מתבצע מחיקה מדורגת, כלומר גם המשאבים הצאצאים של המרחב המשותף – כמו הודעות שפורסמו במרחב המשותף והרשאות החברות במרחב המשותף – נמחקים. דוגמה לכך מופיעה במאמר מחיקה של מרחב משותף.
יש תמיכה בסוגי אימות הבאים:
תצוגה מקדימה למפתחים: אימות אפליקציה עם אישור של האדמין. המרחב המשותף צריך להיווצר באפליקציית Chat באמצעות אימות של אפליקציה.
אימות משתמש אפשר לאמת את השיטה הזו ולהעניק לה הרשאה עם הרשאות אדמין על ידי הגדרת השדה useAdminAccess בבקשה.
בקשת HTTP
DELETE https://chat.googleapis.com/v1/{name=spaces/*}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
| פרמטרים |
name |
string
חובה. שם המשאב של המרחב המשותף שרוצים למחוק. פורמט: spaces/{space}
|
פרמטרים של שאילתה
| פרמטרים |
useAdminAccess |
boolean
זה שינוי אופציונלי. כשהערך של true הוא true, השיטה פועלת באמצעות הרשאות האדמין של המשתמש ב-Google Workspace. המשתמש הקורא חייב להיות אדמין ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים משותפים. נדרשת הרשאת OAuth 2.0 chat.admin.delete.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה הוא אובייקט 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-03-13 (שעון UTC).
[null,null,["עדכון אחרון: 2025-03-13 (שעון 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"]]
