Method: subscriptions.patch

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

בקשת HTTP

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

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

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

פרמטרים
subscription.name

string

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

פורמט: subscriptions/{subscription}

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

פרמטרים
updateMask

string (FieldMask format)

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

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

  • expireTime: חותמת הזמן של תוקף המינוי.
  • ttl: משך החיים (TTL) או משך המינוי.

כדי להחליף את המינוי באופן מלא (שווה ערך ל-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

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