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

詳情請參閱授權指南。