Method: spaces.members.list

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

ต้องตรวจสอบสิทธิ์ รองรับการตรวจสอบสิทธิ์บัญชีบริการและการตรวจสอบสิทธิ์ผู้ใช้อย่างเต็มรูปแบบ การตรวจสอบสิทธิ์ผู้ใช้

คำขอ HTTP

GET https://chat.googleapis.com/v1/{parent=spaces/*}/members

URL ใช้ไวยากรณ์ gRPC Transcoding

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

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

string

ต้องระบุ ชื่อทรัพยากรของพื้นที่ทํางานที่จะดึงข้อมูลรายการการเป็นสมาชิก

รูปแบบ: พื้นที่ทํางาน/{space}

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

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

integer

ไม่บังคับ จํานวนการเป็นสมาชิกสูงสุดที่จะส่งคืน บริการอาจแสดงผลน้อยกว่าค่านี้

หากไม่ระบุ ระบบจะแสดงผลการเป็นสมาชิกได้สูงสุด 100 รายการ

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

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

string

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

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

string

ไม่บังคับ ตัวกรองการค้นหา

คุณกรองการเป็นสมาชิกได้ตามบทบาท (role) ของสมาชิกและประเภท (member.type)

หากต้องการกรองตามบทบาท ให้ตั้งค่า role เป็น ROLE_MEMBER หรือ ROLE_MANAGER

หากต้องการกรองตามประเภท ให้ตั้งค่า member.type เป็น HUMAN หรือ BOT

หากต้องการกรองตามบทบาทและประเภท ให้ใช้โอเปอเรเตอร์ AND หากต้องการกรองตามบทบาทหรือประเภท ให้ใช้โอเปอเรเตอร์ OR

ตัวอย่างเช่น ข้อความค้นหาต่อไปนี้ถูกต้อง:

role = "ROLE_MANAGER" OR role = "ROLE_MEMBER"
member.type = "HUMAN" AND role = "ROLE_MANAGER"

ข้อความค้นหาต่อไปนี้ไม่ถูกต้อง:

member.type = "HUMAN" AND member.type = "BOT"
role = "ROLE_MANAGER" AND role = "ROLE_MEMBER"

เซิร์ฟเวอร์ปฏิเสธคําค้นหาที่ไม่ถูกต้องโดยมีข้อผิดพลาด INVALID_ARGUMENT
showGroups

boolean

ไม่บังคับ เมื่อ true แสดงการเป็นสมาชิกที่เชื่อมโยงกับ Google Group ด้วย นอกเหนือจากการเป็นสมาชิกประเภทอื่นๆ หากตั้งค่า filter ระบบจะไม่แสดงผลการเป็นสมาชิก Google Group ที่ไม่ตรงกับเกณฑ์ตัวกรอง

showInvited

boolean

ไม่บังคับ เมื่อ true จะส่งคืนการเป็นสมาชิกที่เชื่อมโยงกับสมาชิก invited ด้วย นอกเหนือจากการเป็นสมาชิกประเภทอื่นๆ หากตั้งค่าตัวกรอง ระบบจะไม่แสดงผลการเป็นสมาชิก invited ที่ไม่ตรงกับเกณฑ์ตัวกรอง

ปัจจุบันต้องมีการตรวจสอบสิทธิ์ผู้ใช้

เนื้อหาของคำขอ

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

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

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

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

object (Membership)

รายการการเป็นสมาชิกในหน้าที่ขอ (หรือหน้าแรก)
nextPageToken

string

โทเค็นที่คุณสามารถส่งเป็น pageToken เพื่อเรียกหน้าถัดไปของผลลัพธ์ หากเว้นว่างไว้ จะไม่มีหน้าเว็บถัดไป

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

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

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly

สําหรับข้อมูลเพิ่มเติม โปรดดูคู่มือการให้สิทธิ์