คู่มือนี้อธิบายวิธีดูรายละเอียดเกี่ยวกับผู้เข้าร่วมที่เข้าร่วมการประชุมในอดีตหรือผู้ที่เข้าร่วมการประชุมที่ใช้งานอยู่ รวมถึงข้อมูลเซสชันของผู้เข้าร่วม โดยใช้ Google Meet REST API
ผู้เข้าร่วมคือบุคคลที่
เข้าร่วมการโทรหรือใช้โหมดแยกหน้าจอประชุม ดูในฐานะผู้ชม หรือ
อุปกรณ์ในห้องประชุมที่เชื่อมต่อกับการโทร โดยจะมีทรัพยากร
participants
1 รายการสำหรับแต่ละบุคคล
เซสชันของผู้เข้าร่วม
คือรหัสเซสชันที่ไม่ซ้ำกันซึ่งสร้างขึ้นสำหรับผู้เข้าร่วมแต่ละรายที่เข้าร่วม
การโทร โดยจะมีทรัพยากร
participantSessions
1 รายการสำหรับแต่ละเซสชัน หากผู้เข้าร่วมเข้าร่วมการโทรเดียวกันหลายครั้งจากผู้เข้าร่วมรายเดียวกัน ระบบจะกำหนดรหัสเซสชันที่ไม่ซ้ำกันให้กับผู้เข้าร่วมแต่ละราย
หากคุณเป็นเจ้าของหรือผู้เข้าร่วมพื้นที่การประชุม คุณสามารถเรียกใช้เมธอด get และ list ในทรัพยากร participants และ participantSessions เพื่อดึงข้อมูลบันทึกของผู้เข้าร่วม
การตรวจสอบสิทธิ์และการให้สิทธิ์ด้วยข้อมูลเข้าสู่ระบบของผู้ใช้จะช่วยให้แอป Google Meet เข้าถึงข้อมูลผู้ใช้และดำเนินการในนามของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ได้ การตรวจสอบสิทธิ์ด้วยการมอบสิทธิ์ ทั่วทั้งโดเมน ช่วยให้คุณให้สิทธิ์บัญชีบริการของแอปพลิเคชันเพื่อเข้าถึงข้อมูลผู้ใช้ โดยไม่ต้องขอความยินยอมจากผู้ใช้แต่ละคน
ผู้เข้าร่วม
ส่วนต่อไปนี้จะอธิบายรายละเอียดเกี่ยวกับวิธีดูข้อมูลเกี่ยวกับผู้เข้าร่วมในบันทึกการประชุม
ทรัพยากร
participants
จะรวมกับช่อง user user จะเป็นออบเจ็กต์ใดออบเจ็กต์หนึ่งต่อไปนี้เท่านั้น
A
signedinUserจะเป็นอย่างใดอย่างหนึ่งต่อไปนี้บุคคลที่เข้าร่วมจากคอมพิวเตอร์ส่วนบุคคล อุปกรณ์เคลื่อนที่ หรือผ่านโหมดแยกหน้าจอประชุม
บัญชีบ็อตที่อุปกรณ์ในห้องประชุมใช้
An
anonymousUserคือผู้ใช้ที่ไม่ระบุตัวตนซึ่งไม่ได้ลงชื่อเข้าใช้บัญชี GoogleA
phoneUserคือผู้ใช้ที่โทรเข้าจากโทรศัพท์ซึ่งไม่ทราบตัวตนของผู้ใช้ เนื่องจากผู้ใช้ไม่ได้ลงชื่อเข้าใช้ด้วยบัญชี Google
โปรดทราบว่าแม้ว่าออบเจ็กต์ทั้ง 3 รายการจะแสดงผล displayName แต่ signedinUser จะแสดงผลรหัส user ที่ไม่ซ้ำกันซึ่งทำงานร่วมกับ Admin SDK API และ People API ได้ด้วย รูปแบบ: users/{user} ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้รหัส user
ID กับ People API ได้ที่หัวข้อดึงข้อมูลรายละเอียดของผู้เข้าร่วมด้วย
People API
ดูรายละเอียดเกี่ยวกับผู้เข้าร่วม
หากต้องการดูรายละเอียดเกี่ยวกับผู้เข้าร่วมที่เฉพาะเจาะจง ให้ใช้
get
เมธอดใน
participants
ทรัพยากร ตั้งค่าพารามิเตอร์เส้นทาง name โดยใช้รูปแบบ conferenceRecords/{conferenceRecord}/participants/{participantRecord}
หากไม่ทราบชื่อผู้เข้าร่วม คุณสามารถ แสดงรายการชื่อผู้เข้าร่วม
ทั้งหมดได้โดยใช้เมธอด list
เมธอดจะแสดงผลข้อมูลผู้เข้าร่วมเป็นอินสแตนซ์ของทรัพยากร participants
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ ACCESS_TOKEN ด้วยโทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API
แทนที่ค่าต่อไปนี้
- ชื่อบันทึกการประชุมด้วยชื่อรหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
- ชื่อผู้เข้าร่วมด้วยชื่อรหัสผู้เข้าร่วมที่เฉพาะเจาะจงในบันทึกการประชุม
แสดงรายการผู้เข้าร่วมทั้งหมด
หากต้องการแสดงรายละเอียดเกี่ยวกับผู้เข้าร่วมทั้งหมดในบันทึกการประชุม ให้ใช้
list
เมธอดใน
participants
ทรัพยากร ตั้งค่าพารามิเตอร์เส้นทาง parent โดยใช้รูปแบบ conferenceRecords/{conferenceRecord}
เมธอดจะแสดงรายการผู้เข้าร่วมการประชุมที่เรียงตาม earliestStartTime จากมากไปน้อยเป็นอินสแตนซ์ของทรัพยากร participants หากต้องการปรับขนาดหน้าและกรองผลการค้นหา โปรดดูหัวข้อ ปรับแต่ง
การแบ่งหน้าหรือกรองรายการผู้เข้าร่วม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการผู้เข้าร่วมทั้งหมดในบันทึกการประชุม
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ ACCESS_TOKEN ด้วยโทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API
แทนที่ชื่อระดับบนด้วยชื่อรหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
ปรับแต่งการแบ่งหน้าหรือกรองรายการผู้เข้าร่วม
ส่งพารามิเตอร์การค้นหาต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองผู้เข้าร่วม
pageSize: จำนวนผู้เข้าร่วมสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงผลผู้เข้าร่วมไม่เกิน 100 ราย ค่าสูงสุดคือ 250 โดยระบบจะเปลี่ยนค่าที่มากกว่า 250 เป็น 250 โดยอัตโนมัติpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกรายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป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:23ZlatestEndTime < 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_CONTACTReadSourceTypeซึ่งจะช่วยให้มั่นใจได้ว่าทั้งผู้ใช้ภายในขององค์กร 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 โดยใช้รูปแบบ conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}
หากไม่ทราบชื่อเซสชันของผู้เข้าร่วม คุณสามารถ แสดงรายการเซสชันของผู้เข้าร่วมทั้งหมดได้โดยใช้เมธอด list
เมธอดจะแสดงผลชื่อผู้เข้าร่วมเป็นอินสแตนซ์ของทรัพยากร participantSessions
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ ACCESS_TOKEN ด้วยโทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API
แทนที่ค่าต่อไปนี้
- ชื่อบันทึกการประชุมด้วยชื่อรหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
- ชื่อผู้เข้าร่วมด้วยชื่อรหัสผู้เข้าร่วมที่เฉพาะเจาะจงในบันทึกการประชุม
- รหัสเซสชันของผู้เข้าร่วมด้วยรหัสของเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง
แสดงรายการเซสชันของผู้เข้าร่วมทั้งหมด
หากต้องการแสดงรายละเอียดเกี่ยวกับเซสชันของผู้เข้าร่วมทั้งหมดในบันทึกการประชุม
ให้ใช้
list()
เมธอดใน
participantSessions
ทรัพยากร ตั้งค่าพารามิเตอร์เส้นทาง parent โดยใช้รูปแบบ conferenceRecords/{conferenceRecord}/participants/{participantRecord}
เมธอดจะแสดงรายการเซสชันของผู้เข้าร่วมที่เรียงตาม startTime จากมากไปน้อยเป็นอินสแตนซ์ของทรัพยากร participantSession หากต้องการปรับ
ขนาดหน้าและกรองผลการค้นหา โปรดดูหัวข้อปรับแต่งการแบ่งหน้าหรือกรอง
รายการเซสชันของผู้เข้าร่วม
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการเซสชันของผู้เข้าร่วมทั้งหมดในบันทึกการประชุม
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
แทนที่ ACCESS_TOKEN ด้วยโทเค็นเพื่อการเข้าถึงที่ให้สิทธิ์เข้าถึง API
แทนที่ค่าต่อไปนี้
- ชื่อบันทึกการประชุมด้วยชื่อรหัสการประชุมที่เฉพาะเจาะจงในบันทึกการประชุม
- ชื่อระดับบนด้วยชื่อเซสชันของผู้เข้าร่วมในบันทึกการประชุม
ปรับแต่งการแบ่งหน้าหรือกรองรายการเซสชันของผู้เข้าร่วม
ส่งพารามิเตอร์การค้นหาที่ไม่บังคับต่อไปนี้เพื่อปรับแต่งการแบ่งหน้าหรือกรองเซสชันของผู้เข้าร่วม
pageSize: จำนวนเซสชันของผู้เข้าร่วมสูงสุดที่จะแสดงผล บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ได้ระบุ ระบบจะแสดงผลเซสชันของผู้เข้าร่วมไม่เกิน 100 รายการ ค่าสูงสุดคือ 250 โดยระบบจะเปลี่ยนค่าที่มากกว่า 250 เป็น 250 โดยอัตโนมัติpageToken: โทเค็นหน้าเว็บที่ได้รับจากการเรียกรายการก่อนหน้า ระบุโทเค็นนี้เพื่อดึงข้อมูลหน้าถัดไป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:23ZendTime < 2023-10-01T15:01:23Z
หากต้องการแสดงรายการเซสชันของผู้เข้าร่วมที่ใช้งานอยู่ทั้งหมดในบันทึกการประชุม ให้ใช้
endTime IS NULL.