คู่มือนี้จะอธิบายวิธีรับรายละเอียดเกี่ยวกับผู้เข้าร่วมที่เข้าร่วมการประชุมที่ผ่านมาหรือผู้ที่อยู่ในการประชุมที่ดำเนินอยู่ รวมถึงข้อมูลเซสชัน โดยใช้ Google Meet REST API
ผู้เข้าร่วมคือบุคคลที่เข้าร่วมการโทรหรือใช้โหมดแยกหน้าจอประชุม ดูในฐานะผู้ชม หรืออุปกรณ์ในห้องที่เชื่อมต่อกับการโทร โดยจะมีแหล่งข้อมูล 1 รายการสำหรับแต่ละคนparticipants
เซสชันของผู้เข้าร่วมคือรหัสเซสชันที่ไม่ซ้ำกันซึ่งสร้างขึ้นสำหรับคู่อุปกรณ์ของผู้เข้าร่วมแต่ละคู่ที่เข้าร่วมการโทร
แต่ละเซสชันจะมีแหล่งข้อมูล 1 รายการ
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 ได้ที่ดึงข้อมูลรายละเอียดผู้เข้าร่วมด้วยผู้คน 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
: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้รายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไปfilter
: ไม่บังคับ ตัวกรองข้อความค้นหาเพื่อดึงข้อมูลรายการที่เฉพาะเจาะจงในผลการค้นหาparticipants
ทรัพยากรคุณสามารถใช้ช่อง
earliestStartTime
หรือlatestEndTime
เพื่อกรองผู้ใช้ที่เข้าร่วมก่อนหรือออกจากหลังช่วงเวลาหนึ่ง ทั้ง 2 ช่องใช้รูปแบบการประทับเวลาในรูปแบบ RFC 3339 UTC "ซูลู" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 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
รหัสสำหรับ Google 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
: โทเค็นหน้าเว็บที่ได้รับจากการเรียกใช้รายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไปfilter
: ไม่บังคับ ตัวกรองข้อความค้นหาเพื่อดึงข้อมูลรายการที่เฉพาะเจาะจงในผลการค้นหาparticipants
ทรัพยากรคุณสามารถใช้ช่อง
startTime
หรือendTime
เพื่อกรองผู้ใช้ที่เข้าร่วมก่อนหรือออกจากหลังช่วงเวลาหนึ่ง ทั้ง 2 ช่องใช้รูปแบบการประทับเวลาในรูปแบบ RFC 3339 UTC "ซูลู" ที่มีความละเอียดระดับนาโนวินาทีและทศนิยมสูงสุด 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