Method: subscriptions.patch

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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

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