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.

Đối với một gói thuê bao trên tài nguyên đích 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/v1beta/{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ầ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 đây trong gói thuê bao:

  • expireTime: Dấu thời gian 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.
  • eventTypes: Danh sách các loại sự kiện sẽ nhận được về tài nguyên đích.

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 được đặt 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 phiên bản đã 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.messages.readonly
  • https://www.googleapis.com/auth/chat.app.spaces
  • https://www.googleapis.com/auth/meetings.space.created
  • https://www.googleapis.com/auth/meetings.space.readonly
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

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