Method: spaces.patch
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
עדכון של מרחב. דוגמה מופיעה במאמר בנושא עדכון מרחב.
אם אתם מעדכנים את השדה displayName ומופיעה הודעת השגיאה ALREADY_EXISTS, נסו להשתמש בשם לתצוגה אחר. יכול להיות ששם התצוגה הזה כבר נמצא בשימוש במרחב קיים בארגון Google Workspace.
יש תמיכה בסוגי האימות הבאים:
יש מגבלות על אימות אפליקציות:
- כדי לעדכן את
space.predefined_permission_settings או את space.permission_settings, האפליקציה צריכה להיות יוצרת המרחב.
- אי אפשר לעדכן את
space.access_settings.audience לצורך אימות אפליקציות.
בקשת HTTP
PATCH https://chat.googleapis.com/v1/{space.name=spaces/*}
כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים |
space.name |
string
מזהה. שם המשאב של המרחב. פורמט: spaces/{space} כאשר {space} מייצג את המזהה שהוקצה למרחב על ידי המערכת. אפשר לקבל את מזהה המרחב באמצעות הפעלת השיטה spaces.list() או מכתובת ה-URL של המרחב. לדוגמה, אם כתובת ה-URL של המרחב היא https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, מזהה המרחב הוא AAAAAAAAA.
|
פרמטרים של שאילתה
| פרמטרים |
updateMask |
string (FieldMask format)
חובה. נתיבי השדות המעודכנים, מופרדים בפסיקים אם יש כמה. אפשר לעדכן את השדות הבאים של המרחב: spaceDetails: עדכון התיאור של המרחב. אפשר להזין עד 150 תווים. displayName: אפשר לעדכן רק את השם המוצג של מרחבים שבהם השדה spaceType הוא SPACE. אם מופיעה הודעת השגיאה ALREADY_EXISTS, מנסים להזין ערך אחר. יכול להיות ששם התצוגה הזה כבר נמצא בשימוש במרחב קיים בארגון Google Workspace. spaceType: אפשר לשנות רק את סוג המרחב GROUP_CHAT ל-SPACE. כוללים את displayName יחד עם spaceType במסכת העדכון, ומוודאים שלמרחב שצוין יש שם לתצוגה שלא ריק ואת סוג המרחב SPACE. אם כבר יש במרחב שצוין את הסוג SPACE, אפשר לא לכלול את המסכה spaceType ואת הסוג SPACE כשמעדכנים את השם לתצוגה. ניסיון לעדכן את סוג המרחב בדרכים אחרות יגרום לשגיאה של ארגומנט לא חוקי. אין תמיכה ב-spaceType עם useAdminAccess. spaceHistoryState: עדכון הגדרות ההיסטוריה של המרחב על ידי הפעלה או השבתה של ההיסטוריה במרחב. האפשרות הזו נתמכת רק אם הגדרות ההיסטוריה מופעלות בארגון ב-Google Workspace. כדי לעדכן את מצב ההיסטוריה של המרחב, צריך להשמיט את כל מסכות השדות האחרות בבקשה. אין תמיכה ב-spaceHistoryState עם useAdminAccess. accessSettings.audience: מעדכן את הגדרת הגישה של מי יכול לגלות את המרחב, להצטרף למרחב ולצפות בתצוגה מקדימה של ההודעות במרחב עם שם, כאשר השדה spaceType הוא SPACE. אם למרחב הקיים יש קהל יעד, אפשר להסיר את הקהל ולהגביל את הגישה למרחב על ידי השמטת ערך למסיכת השדה הזו. כדי לעדכן את הגדרות הגישה למרחב, המשתמש המאומת צריך להיות מנהל המרחב ולהשמיט את כל שאר מסכות השדות בבקשה. אי אפשר לעדכן את השדה הזה אם המרחב נמצא במצב ייבוא. מידע נוסף זמין במאמר בנושא הגדרת מרחב כגלוי למשתמשים ספציפיים. אין תמיכה ב-accessSettings.audience עם useAdminAccess. permissionSettings: תומך בשינוי הגדרות ההרשאות של מרחב. כשמעדכנים את הגדרות ההרשאות, אפשר לציין רק מסכות שדות של permissionSettings. אי אפשר לעדכן מסכות שדות אחרות בו-זמנית. אין תמיכה ב-permissionSettings עם useAdminAccess. מסכות השדות הנתמכות כוללות:
permissionSettings.manageMembersAndGroupspermissionSettings.modifySpaceDetailspermissionSettings.toggleHistorypermissionSettings.useAtMentionAllpermissionSettings.manageAppspermissionSettings.manageWebhookspermissionSettings.replyMessages
|
useAdminAccess |
boolean
אופציונלי. כשמגדירים את true, השיטה מופעלת באמצעות הרשאות האדמין של המשתמש ב-Google Workspace. המשתמש שמבצע את השיחה צריך להיות אדמין ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים. נדרש chat.admin.spaces היקף הרשאות OAuth 2.0. חלק מהערכים של FieldMask לא נתמכים בגישת אדמין. פרטים נוספים זמינים בתיאור של updateMask.
|
גוף הבקשה
גוף הבקשה מכיל מופע של Space.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של Space.
היקפי הרשאה
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/chat.app.spaceshttps://www.googleapis.com/auth/chat.admin.spaceshttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.spaces
מידע נוסף זמין במדריך ההרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-29 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-29 (שעון UTC)."],[[["\u003cp\u003eUpdates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges.\u003c/p\u003e\n"],["\u003cp\u003eSupports partial updates using the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields to be modified.\u003c/p\u003e\n"],["\u003cp\u003eProvides options for using administrator privileges with the \u003ccode\u003euseAdminAccess\u003c/code\u003e query parameter, but some fields and functionalities are not supported in this mode.\u003c/p\u003e\n"],["\u003cp\u003eUses the PATCH HTTP method and gRPC Transcoding syntax for the request URL.\u003c/p\u003e\n"]]],["This content describes how to update a space within Google Workspace Chat via the API. Key actions include sending a `PATCH` request to `https://chat.googleapis.com/v1/{space.name=spaces/*}`, specifying the space's name in the path. The `updateMask` query parameter defines which fields to update, including space details, display name, type, history state, access and permissions. `useAdminAccess` allow to update the space with administrator permissions. Authentication requires specific OAuth scopes. The request and response body use the `Space` object.\n"],null,[]]
