Method: subscriptions.patch

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

如果是 Chat 目標資源的訂閱項目，您可以透過下列方式更新訂閱項目：

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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • 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

詳情請參閱授權指南。