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.manageMembersAndGroups
  • permissionSettings.modifySpaceDetails
  • permissionSettings.toggleHistory
  • permissionSettings.useAtMentionAll
  • permissionSettings.manageApps
  • permissionSettings.manageWebhooks
  • permissionSettings.replyMessages
useAdminAccess

boolean

זה שינוי אופציונלי. כשהערך הוא true, השיטה תפעל עם הרשאות האדמין של המשתמש ב-Google Workspace.

המשתמש הקורא חייב להיות אדמין ב-Google Workspace עם הרשאה לניהול צ'אטים ושיחות במרחבים משותפים.

נדרשת הרשאת OAuth 2.0 chat.admin.spaces.

חלק מהערכים של FieldMask לא נתמכים באמצעות הרשאת אדמין. פרטים נוספים זמינים בתיאור של updateMask.

גוף הבקשה

גוף הבקשה מכיל מופע של Space.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של Space.

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.admin.spaces
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.spaces

מידע נוסף זמין במדריך להרשאות.