Method: users.sections.list

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

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

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

คำขอ HTTP

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

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

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

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

string

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

  • ชื่อแทน me เช่น users/me

  • อีเมล Workspace ของผู้ใช้ เช่น users/user@example.com

  • รหัสผู้ใช้ เช่น users/123456789

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

พารามิเตอร์การค้นหา

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

integer

ไม่บังคับ จำนวนสูงสุดของส่วนที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงผลไม่เกิน 10 ส่วน

ค่าสูงสุดคือ 100 หากใช้ค่ามากกว่า 100 ระบบจะเปลี่ยนเป็น 100 โดยอัตโนมัติ

ค่าลบจะแสดงผลข้อผิดพลาด INVALID_ARGUMENT
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้ list sections ก่อนหน้า ระบุข้อมูลนี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุควรตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ การส่งค่าที่แตกต่างกันไปยังพารามิเตอร์อื่นๆ อาจทําให้ได้ผลลัพธ์ที่ไม่คาดคิด

เนื้อความของคำขอ

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

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

ข้อความตอบกลับสำหรับส่วนข้อมูล

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "sections": [
    {
      object (Section)
    }
  ],
  "nextPageToken": string
}
ช่อง
sections[]

object (Section)

ส่วนจากผู้ใช้ที่ระบุ
nextPageToken

string

โทเค็นที่ส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไปได้ หากละเว้นช่องนี้ จะไม่มีหน้าถัดไป

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

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

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

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