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.

Đối với gói thuê bao trên tài nguyên mục tiêu của Chat, bạn có thể cập nhật gói thuê bao như sau:

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

Số 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ần cập nhật. Nếu bạn bỏ qua, hệ thống sẽ 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 cần nhận về tài nguyên mục tiêu.

Khi sử dụng ký tự đại diện * (tương đương với PUT), các trường bị bỏ qua sẽ được đặt thành giá trị trống và bị từ chối nếu không hợp lệ.
validateOnly

boolean

Không bắt buộc. Nếu bạn đặt thành true, hệ thống 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 thực thể 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/chat.app.memberships
  • https://www.googleapis.com/auth/chat.app.memberships.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/chat.app.spaces.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 về Uỷ quyền.