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