Method: subscriptions.patch

עדכון או חידוש של מינוי ל-Google Workspace. כך מעדכנים או מחדשים מינוי ל-Google Workspace.

במינוי למקור מידע של יעד ב-Chat, אפשר לעדכן את המינוי כך:

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.all.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.all.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.spaces.readonly
  • https://www.googleapis.com/auth/chat.app.all.users.readstate.readonly
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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