Method: subscriptions.patch

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

HTTP 要求

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

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

路徑參數

參數
subscription.name

string

選用設定。不可變動。ID。訂閱項目的資源名稱。

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

詳情請參閱授權指南。