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) 或时长。

如需完全替换订阅(相当于 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

有关详情,请参阅授权指南