Method: subscriptions.patch

Cập nhật hoặc gia hạn gói thuê bao của 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 của 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

Tham số
subscription.name

string

Không bắt buộc. Không thể thay đổi. 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

Tham số
updateMask

string (FieldMask format)

Không bắt buộc. Trường cần 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 đây 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 hạn của gói thuê bao.

Để 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 đều được cập nhật bằng giá trị trống.
validateOnly

boolean

Không bắt buộc. Nếu bạn đặt chính sách này thành true, thì 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 đây:

  • 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 bài viết Hướng dẫn uỷ quyền.