Method: users.availability.patch

Cập nhật thông tin về tình trạng rảnh/bận của người dùng là con người. Bạn chỉ có thể cập nhật trường customStatus thông qua phương thức này.

Phương thức này chỉ cập nhật trạng thái rảnh/bận của người dùng đã xác thực.

Yêu cầu xác thực người dùng bằng một trong các phạm vi uỷ quyền sau:

  • https://www.googleapis.com/auth/chat.users.availability

Yêu cầu HTTP

PATCH https://chat.googleapis.com/v1/{availability.name=users/*/availability}

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

Tham số đường dẫn

Thông số
availability.name

string

Giá trị nhận dạng. Tên tài nguyên về tình trạng còn phòng của người dùng.

Định dạng users/{user}/availability

{user} là mã nhận dạng của Người dùng trong People API hoặc Admin SDK Directory API. Ví dụ: users/123456789.

Địa chỉ email hoặc me của người dùng cũng có thể được dùng làm tên thay thế để chỉ người gọi. Ví dụ: users/user@example.com hoặc users/me

Tham số truy vấn

Tham số
updateMask

string (FieldMask format)

Bắt buộc. Danh sách các trường cần cập nhật. Trường duy nhất có thể cập nhật là customStatus.

Nội dung yêu cầu

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

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 Availability.

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.users.availability

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