Method: subscriptions.patch

• HTTP 请求
• 路径参数
• 查询参数
• 请求正文
• 响应正文
• 授权范围

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

HTTP 请求

PATCH https://workspaceevents.googleapis.com/v1/{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

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