Method: users.availability.get

แสดงข้อมูลความพร้อมใช้งานของผู้ใช้ที่เป็นบุคคลใน Google Chat เช่น ใช้เพื่อตรวจสอบว่าผู้ใช้ออนไลน์หรือไม่อยู่ หรือเพื่อดึงข้อความสถานะที่กำหนดเองของผู้ใช้

เมธอดนี้จะดึงข้อมูลความพร้อมใช้งานของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เท่านั้น

ต้องมีการตรวจสอบสิทธิ์ผู้ใช้ด้วยขอบเขตการให้สิทธิ์ต่อไปนี้ขอบเขตใดขอบเขตหนึ่ง:

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อทรัพยากรของความพร้อมใช้งานที่จะดึงข้อมูล

รูปแบบ: users/{user}/availability

{user} คือรหัสของบุคคลใน People API หรือ Admin SDK Directory API เช่น users/123456789

นอกจากนี้ คุณยังใช้อีเมลของผู้ใช้หรือ me เป็นชื่อแทนเพื่ออ้างอิงผู้โทรได้ด้วย เช่น users/user@example.com หรือ users/me

เนื้อหาคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Availability

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้ขอบเขตใดขอบเขตหนึ่ง

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

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์