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/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

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