Method: subscriptions.patch

עדכון או חידוש של מינוי ל-Google Workspace. במאמר עדכון או חידוש של מינוי ל-Google Workspace מוסבר איך משתמשים בשיטה הזו.

בקשת HTTP

PATCH https://workspaceevents.googleapis.com/v1beta/{subscription.name=subscriptions/*}

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
subscription.name

string

מזהה. שם המשאב של המינוי.

פורמט: subscriptions/{subscription}

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

זה שינוי אופציונלי. השדה שרוצים לעדכן. אם לא צוין, המערכת מעדכנת את כל השדות הכלולים בבקשה.

אפשר לעדכן אחד מהשדות הבאים במינוי:

  • expireTime: חותמת הזמן שבה יפוג התוקף של המינוי.
  • ttl: אורך החיים (TTL) או משך המינוי.
  • eventTypes: רשימה של סוגי האירועים שיש לקבל לגבי משאב היעד.

כדי להחליף את המינוי באופן מלא (המקביל ל-PUT), משתמשים ב-*. כל שדה שלא נכלל מתעדכנים בערכים ריקים.
validateOnly

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת לערך true, הבקשה מאמתת ומציגה את הבקשה בתצוגה מקדימה, אבל לא מעדכנת את המינוי.

גוף הבקשה

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

גוף התשובה

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

  • השדה metadata מכיל מערך ריק.
  • השדה response מכיל מופע מעודכן של Subscription.

היקפי ההרשאות

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

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly

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