Method: users.availability.get

Trả về thông tin về trạng thái hoạt động của người dùng là con người trong Google Chat. Ví dụ: bạn có thể dùng phương thức này để kiểm tra xem người dùng đang trực tuyến hay không hoạt động, hoặc để truy xuất thông báo trạng thái tuỳ chỉnh của họ.

Phương thức này chỉ truy xuấ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.readonly
  • https://www.googleapis.com/auth/chat.users.availability

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
name

string

Bắt buộc. Tên tài nguyên của lịch rảnh cần truy xuất.

Đị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

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

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
  • https://www.googleapis.com/auth/chat.users.availability.readonly

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