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

有关详情，请参阅授权指南。