Method: subscriptions.patch

更新或續訂 Google Workspace 訂閱。如要瞭解如何使用這項方法,請參閱「更新或續訂 Google Workspace 訂閱方案」。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
subscription.name

string

ID。訂閱項目的資源名稱。

格式: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

詳情請參閱授權指南