Method: subscriptions.patch

Cập nhật hoặc gia hạn gói thuê bao Google Workspace. Để tìm hiểu cách sử dụng phương thức này, hãy xem bài viết Cập nhật hoặc gia hạn gói thuê bao Google Workspace.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
subscription.name

string

Giá trị nhận dạng. Tên tài nguyên của gói thuê bao.

Định dạng subscriptions/{subscription}

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Không bắt buộc. Trường để cập nhật. Nếu bị bỏ qua, hãy cập nhật mọi trường có trong yêu cầu.

Bạn có thể cập nhật một trong các trường sau trong gói thuê bao:

  • expireTime: Dấu thời gian khi gói thuê bao hết hạn.
  • ttl: Thời gian tồn tại (TTL) hoặc thời lượng của gói thuê bao.
  • eventTypes: Danh sách các loại sự kiện sẽ nhận được về tài nguyên mục tiêu.

Để thay thế hoàn toàn gói thuê bao (tương đương với PUT), hãy sử dụng *. Mọi trường bị bỏ qua sẽ được cập nhật bằng giá trị trống.
validateOnly

boolean

Không bắt buộc. Nếu được đặt thành true, sẽ xác thực và xem trước yêu cầu, nhưng không cập nhật gói thuê bao.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Subscription.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của Operation.

  • Trường metadata chứa một mảng trống.
  • Trường response chứa một thực thể đã cập nhật của Subscription.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.