Method: subscriptions.patch

更新或续订 Google Workspace 订阅。如需了解如何使用此方法，请参阅更新或续订 Google Workspace 订阅。

对于聊天目标资源的订阅，您可以按以下方式更新订阅：

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
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.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

如需了解详情，请参阅授权指南。