คู่มือนี้อธิบายวิธีดูรายละเอียดเกี่ยวกับผู้เข้าร่วมที่เข้าร่วมการประชุมที่ผ่านมา หรือผู้ที่เข้าร่วมการประชุมที่กำลังดำเนินอยู่ รวมถึงข้อมูลเซสชัน โดยใช้ REST API ของ Google Meet
ผู้เข้าร่วมคือบุคคลที่เข้าร่วมการโทรหรือใช้โหมดแยกหน้าจอประชุม ดูในฐานะผู้ชม หรืออุปกรณ์ในห้องที่เชื่อมต่อกับการโทร โดยมีแหล่งข้อมูล
participants
สำหรับแต่ละคน
เซสชันของผู้เข้าร่วมคือรหัสเซสชันที่ไม่ซ้ำกันซึ่งสร้างขึ้นสําหรับคู่ผู้เข้าร่วม-อุปกรณ์แต่ละคู่ที่เข้าร่วมการโทร
มี
participantSessions
ทรัพยากรสำหรับแต่ละเซสชัน หากผู้เข้าร่วมเข้าร่วมการโทรเดียวกันหลายครั้ง
จากคู่ผู้เข้าร่วม-อุปกรณ์เดียวกัน ระบบจะกำหนดรหัสเซสชันที่ไม่ซ้ำกันให้แต่ละครั้ง
หากคุณเป็นเจ้าของหรือผู้เข้าร่วมในพื้นที่การประชุม คุณสามารถเรียกใช้เมธอด get()
และ list()
ในทั้งทรัพยากร participants
และ participantSessions
เพื่อดึงข้อมูลบันทึกของผู้เข้าร่วมได้
การตรวจสอบสิทธิ์และการให้สิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้ช่วยให้แอป Google Meet เข้าถึงข้อมูลผู้ใช้และดำเนินการในนามของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้ การตรวจสอบสิทธิ์ด้วยการมอบสิทธิ์ ทั่วทั้งโดเมนช่วยให้ คุณให้สิทธิ์บัญชีบริการของแอปพลิเคชันเพื่อเข้าถึงข้อมูลของผู้ใช้ ได้โดยไม่ต้องขอความยินยอมจากผู้ใช้แต่ละคน
ผู้เข้าร่วม
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีรับข้อมูลเกี่ยวกับผู้เข้าร่วมใน บันทึกการประชุม
participants
การรวมทรัพยากรกับฟิลด์ user
user
อาจเป็นออบเจ็กต์ใดออบเจ็กต์หนึ่งต่อไปนี้เท่านั้น
signedinUser
คือบุคคลที่เข้าร่วมจากคอมพิวเตอร์ส่วนตัว อุปกรณ์เคลื่อนที่ หรือ ผ่านโหมดคู่
บัญชีหุ่นยนต์ที่อุปกรณ์ห้องประชุมใช้
anonymousUser
คือผู้ใช้ที่ไม่ระบุตัวตนซึ่งไม่ได้ลงชื่อเข้าใช้บัญชี GooglephoneUser
คือผู้ใช้ที่โทรเข้ามาจากโทรศัพท์ซึ่งไม่ทราบตัวตนของผู้ใช้ เนื่องจากผู้ใช้ไม่ได้ลงชื่อเข้าใช้ด้วยบัญชี Google
โปรดทราบว่าแม้ว่าออบเจ็กต์ทั้ง 3 รายการจะแสดง displayName
แต่ signedinUser
ยังแสดงรหัส user
ที่ไม่ซ้ำกันซึ่งทำงานร่วมกับ Admin SDK API และ People API ได้
รูปแบบ: users/{user}
ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ user
ID กับ People API ได้ที่ดึงรายละเอียดผู้เข้าร่วมด้วย People API
ดูรายละเอียดเกี่ยวกับผู้เข้าร่วม
หากต้องการดูรายละเอียดเกี่ยวกับผู้เข้าร่วมที่เฉพาะเจาะจง ให้ใช้วิธี
get()
ในแหล่งข้อมูล
participants
ที่มีพารามิเตอร์เส้นทาง name
หากไม่ทราบชื่อผู้เข้าร่วม
คุณสามารถแสดงชื่อผู้เข้าร่วมทั้งหมดได้โดยใช้เมธอด list()
เมธอดจะแสดงผลข้อมูลผู้เข้าร่วมเป็นอินสแตนซ์ของparticipants
ทรัพยากร
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
แทนที่ชื่อผู้เข้าร่วมด้วยชื่อรหัสผู้เข้าร่วมที่เฉพาะเจาะจงใน บันทึกการประชุม
แสดงรายชื่อผู้เข้าร่วมทั้งหมด
หากต้องการแสดงรายละเอียดเกี่ยวกับผู้เข้าร่วมทั้งหมดในบันทึกการประชุม ให้ใช้เมธอด
list()
ในแหล่งข้อมูล
participants
ที่มีพารามิเตอร์เส้นทาง parent
รูปแบบ
conferenceRecords/{conferenceRecord}
เมธอดจะแสดงรายการผู้เข้าร่วมการประชุมโดยเรียงตามearliestStartTime
จากมากไปน้อยเป็นอินสแตนซ์ของทรัพยากร participants
หากต้องการปรับขนาดหน้าและกรองผลการค้นหา ให้ดูปรับแต่ง
การแบ่งหน้าหรือกรองรายชื่อผู้เข้าร่วม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายชื่อผู้เข้าร่วมทั้งหมดในการบันทึกการประชุม
Java
Node.js
Python
แทนที่ค่าขององค์ประกอบหลักด้วยชื่อของระเบียนการประชุม
ปรับแต่งการแบ่งหน้าหรือกรองรายชื่อผู้เข้าร่วม
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรอง ผู้เข้าร่วม
pageSize
: จำนวนผู้เข้าร่วมสูงสุดที่จะกลับมา บริการอาจ แสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงผู้เข้าร่วมสูงสุด 100 คน ค่าสูงสุดคือ 250 และระบบจะเปลี่ยนค่าที่มากกว่า 250 เป็น 250 โดยอัตโนมัติpageToken
: โทเค็นหน้าเว็บที่ได้รับจากการเรียก list ก่อนหน้า ระบุโทเค็นนี้ เพื่อดึงข้อมูลหน้าถัดไปfilter
: ไม่บังคับ ตัวกรองการค้นหาเพื่อดึงข้อมูลรายการที่เฉพาะเจาะจงในparticipants
ผลลัพธ์ของทรัพยากรคุณสามารถใช้ช่อง
earliestStartTime
หรือlatestEndTime
เพื่อกรองหา ผู้ใช้ที่เข้าร่วมก่อนหรือออกจากแชทหลังเวลาที่กำหนด ทั้ง 2 ฟิลด์ใช้รูปแบบ การประทับเวลา ในรูปแบบ RFC 3339 UTC "Zulu" โดยมีความละเอียดเป็นนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
เช่นearliestStartTime < 2023-10-01T15:01:23Z
latestEndTime < 2023-10-01T15:01:23Z
หากต้องการแสดงรายชื่อผู้เข้าร่วมที่ใช้งานอยู่ทั้งหมดในการประชุมที่มีอยู่ ให้ใช้
latestEndTime IS NULL
เรียกดูรายละเอียดผู้เข้าร่วมด้วย People API
หากต้องการเรียกข้อมูลรายละเอียดเกี่ยวกับผู้เข้าร่วม ให้ใช้เมธอด
get()
ในแหล่งข้อมูล
people
ใน People API
ดึงข้อมูลรหัสของบุคคลจากทรัพยากร
participant
โดยใช้ คอมโพเนนต์สุดท้ายของเส้นทาง เช่น หากค่าparticipant
ทรัพยากร คือconferenceRecords/abc-123/participants/12345
รหัสสำหรับ People API คือ12345
ใส่
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
และREAD_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
วิธีนี้จะช่วยให้ทั้งผู้ใช้ภายในองค์กร Google Workspace และรายชื่อติดต่อภายนอกรวมอยู่ในคำตอบ
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีค้นหาทั้งโปรไฟล์องค์กรและ รายชื่อติดต่อของบุคคล
cURL
curl \
'https://people.googleapis.com/v1/people/PERSON_ID?personFields=names%2CemailAddresses&sources=READ_SOURCE_TYPE_OTHER_CONTACT&sources=READ_SOURCE_TYPE_PROFILE&sources=READ_SOURCE_TYPE_CONTACT' \
--header 'Authorization: Bearer ACCESS_TOKEN' \
--header 'Accept: application/json' \
--compressed
แทนที่ค่าต่อไปนี้
- PERSON_ID: รหัสของบุคคลที่จะค้นหา
- ACCESS_TOKEN: โทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API หลายรายการ
เซสชันของผู้เข้าร่วม
ส่วนต่อไปนี้จะอธิบายรายละเอียดวิธีรับข้อมูลเกี่ยวกับเซสชันของผู้เข้าร่วม ของผู้เข้าร่วมในการบันทึกการประชุม
ดูรายละเอียดเกี่ยวกับเซสชันของผู้เข้าร่วม
หากต้องการดูรายละเอียดเกี่ยวกับเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง ให้ใช้วิธี
get()
ในแหล่งข้อมูล
participantSessions
ที่มีพารามิเตอร์เส้นทาง name
หากไม่ทราบชื่อเซสชันของผู้เข้าร่วม
คุณสามารถแสดงเซสชันของผู้เข้าร่วมทั้งหมดของ
ผู้เข้าร่วมโดยใช้วิธีlist()
เมธอดจะแสดงชื่อผู้เข้าร่วมเป็นอินสแตนซ์ของparticipantSessions
ทรัพยากร
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
แทนที่ชื่อผู้เข้าร่วมด้วยชื่อของรหัสเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจงในเซสชันของผู้เข้าร่วม
แสดงเซสชันของผู้เข้าร่วมทั้งหมด
หากต้องการแสดงรายละเอียดเกี่ยวกับเซสชันของผู้เข้าร่วมทั้งหมดของผู้เข้าร่วมในการบันทึกการประชุม
ให้ใช้เมธอด
list()
ในแหล่งข้อมูล
participantSessions
ที่มีพารามิเตอร์เส้นทาง parent
รูปแบบ
conferenceRecords/{conferenceRecord}/participants/{participant}
เมธอดจะแสดงผลรายการเซสชันของผู้เข้าร่วม โดยเรียงตามstartTime
จากมากไปน้อย
เป็นอินสแตนซ์ของทรัพยากร participantSession
หากต้องการปรับ
ขนาดหน้าเว็บและกรองผลการค้นหา ให้ดูปรับแต่งการแบ่งหน้าหรือกรอง
รายการเซสชันของผู้เข้าร่วม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงเซสชันของผู้เข้าร่วมทั้งหมดใน บันทึกการประชุม
Java
Node.js
Python
แทนที่ค่าหลักด้วยชื่อเซสชันของผู้เข้าร่วมของ ผู้เข้าร่วมในบันทึกการประชุม
ปรับแต่งการแบ่งหน้าหรือกรองรายการเซสชันของผู้เข้าร่วม
ส่งพารามิเตอร์การค้นหาที่ไม่บังคับต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือ กรองเซสชันของผู้เข้าร่วม
pageSize
: จำนวนเซสชันของผู้เข้าร่วมสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลเซสชันของผู้เข้าร่วมสูงสุด 100 รายการ ค่าสูงสุดคือ 250 และระบบจะเปลี่ยนค่าที่มากกว่า 250 เป็น 250 โดยอัตโนมัติpageToken
: โทเค็นหน้าเว็บที่ได้รับจากการเรียก list ก่อนหน้า ระบุโทเค็นนี้ เพื่อดึงข้อมูลหน้าถัดไปfilter
: ไม่บังคับ ตัวกรองการค้นหาเพื่อดึงข้อมูลรายการที่เฉพาะเจาะจงในparticipants
ผลลัพธ์ของทรัพยากรคุณสามารถใช้ช่อง
startTime
หรือendTime
เพื่อกรองผู้ใช้ที่เข้าร่วมก่อนหรือออกจากกลุ่มหลังเวลาที่กำหนด ทั้ง 2 ฟิลด์ใช้รูปแบบ การประทับเวลา ในรูปแบบ RFC 3339 UTC "Zulu" โดยมีความละเอียดเป็นนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z
เช่นstartTime < 2023-10-01T15:01:23Z
endTime < 2023-10-01T15:01:23Z
หากต้องการแสดงเซสชันของผู้เข้าร่วมที่ใช้งานอยู่ทั้งหมดในบันทึกการประชุม ให้ใช้
endTime IS NULL