עדכון של מרחב. דוגמה מופיעה במאמר בנושא עדכון מרחב.
אם אתם מעדכנים את השדה displayName ומופיעה הודעת השגיאה ALREADY_EXISTS, נסו להשתמש בשם לתצוגה אחר. יכול להיות ששם התצוגה הזה כבר נמצא בשימוש במרחב קיים בארגון Google Workspace.
כאשר {space} מייצג את המזהה שהוקצה למרחב על ידי המערכת. אפשר לקבל את מזהה המרחב באמצעות הפעלת השיטה spaces.list() או מכתובת ה-URL של המרחב. לדוגמה, אם כתובת ה-URL של המרחב היא https://mail.google.com/mail/u/0/#chat/space/AAAAAAAAA, מזהה המרחב הוא AAAAAAAAA.
חובה. נתיבי השדות המעודכנים, מופרדים בפסיקים אם יש כמה.
אפשר לעדכן את השדות הבאים של המרחב:
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.manageMembersAndGroups
permissionSettings.modifySpaceDetails
permissionSettings.toggleHistory
permissionSettings.useAtMentionAll
permissionSettings.manageApps
permissionSettings.manageWebhooks
permissionSettings.replyMessages
useAdminAccess
boolean
אופציונלי. כשמגדירים את true, השיטה מופעלת באמצעות הרשאות האדמין של המשתמש ב-Google Workspace.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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,[]]
