אם מעדכנים את השדה displayName ומופיעה הודעת השגיאה ALREADY_EXISTS, מנסים שם לתצוגה אחר. יכול להיות שכבר יש מרחב משותף בארגון ב-Google Workspace עם השם המוצג הזה.
כאשר {space} מייצג את המזהה שהמערכת הקצה למרחב המשותף. אפשר לקבל את מזהה המרחב המשותף על ידי קריאה ל-method 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 הוא 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-05-07 (שעון UTC)."],[[["Updates a Google Chat space's details, including display name, description, space type, history settings, access settings, and permission settings."],["Requires specific authentication and authorization, including app authentication with administrator approval or user authentication, potentially with administrator privileges."],["Supports partial updates using the `updateMask` query parameter to specify the fields to be modified."],["Provides options for using administrator privileges with the `useAdminAccess` query parameter, but some fields and functionalities are not supported in this mode."],["Uses the PATCH HTTP method and gRPC Transcoding syntax for the request URL."]]],["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"]]
