ผู้เข้าร่วมคือบุคคลที่เข้าร่วมการโทรหรือใช้โหมดแยกหน้าจอประชุม ดูในฐานะผู้ชม หรืออุปกรณ์ในห้องที่เชื่อมต่อกับการโทร โดยจะมีแหล่งข้อมูล 1 รายการสำหรับแต่ละคนconferenceRecords.participants
เซสชันของผู้เข้าร่วมคือรหัสเซสชันที่ไม่ซ้ำกันซึ่งสร้างขึ้นสำหรับคู่อุปกรณ์ของผู้เข้าร่วมแต่ละคู่ที่เข้าร่วมการโทร
แต่ละเซสชันจะมีแหล่งข้อมูล 1 รายการ
conferenceRecords.participants.participantSessions
หากผู้เข้าร่วมเข้าร่วมการโทรเดียวกันหลายครั้งจากคู่ผู้เข้าร่วม-อุปกรณ์เดียวกัน ระบบจะกำหนดรหัสเซสชันที่ไม่ซ้ำกันให้กับผู้เข้าร่วมแต่ละราย
หน้านี้อธิบายวิธีรับข้อมูลเกี่ยวกับผู้เข้าร่วมทุกคนที่เข้าร่วมหรืออยู่ในการประชุม หรือเกี่ยวกับผู้เข้าร่วมเพียงคนเดียว รวมถึงข้อมูลเซสชันของผู้เข้าร่วม
ผู้เข้าร่วม
ส่วนต่อไปนี้จะอธิบายรายละเอียดเกี่ยวกับวิธีรับข้อมูลผู้เข้าร่วม
แหล่งข้อมูล conferenceRecords.participants
มีช่อง user
user
ต้องเป็นออบเจ็กต์อย่างใดอย่างหนึ่งต่อไปนี้เท่านั้น
signedinUser
อาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้บุคคลที่เข้าร่วมจากคอมพิวเตอร์ส่วนบุคคล อุปกรณ์เคลื่อนที่ หรือผ่านโหมดอุปกรณ์เสริม
บัญชีโรบ็อตที่อุปกรณ์ห้องประชุมใช้
anonymousUser
คือผู้ใช้ที่ไม่ระบุตัวตนซึ่งไม่ได้ลงชื่อเข้าใช้บัญชี GooglephoneUser
เป็นผู้ใช้ที่โทรเข้ามาจากโทรศัพท์ซึ่งไม่ทราบตัวตนของผู้ใช้เนื่องจากไม่ได้ลงชื่อเข้าใช้ด้วยบัญชี Google
ค้นหาผู้เข้าร่วมทั้งหมด
หากต้องการดูรายละเอียดเกี่ยวกับผู้เข้าร่วมทั้งหมดในระเบียนการประชุม ให้ใช้เมธอด list()
ในทรัพยากร conferenceRecords.participants
ที่มีพารามิเตอร์เส้นทาง parent
คุณสามารถใช้ช่อง 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
เมธอดนี้จะแสดงรายการผู้เข้าร่วมการประชุม โดยจัดเรียงตามเวลาที่เข้าร่วมจากมากไปน้อย ในรูปแบบอินสแตนซ์ของทรัพยากร conferenceRecords.participants
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายชื่อผู้เข้าร่วมทั้งหมดในระเบียนการประชุม
Java
Node.js
Python
แทนที่ค่าของรายการหลักด้วยชื่อของระเบียนการประชุม
ค้นหาผู้เข้าร่วมที่เฉพาะเจาะจง
หากต้องการค้นหาผู้เข้าร่วมที่เฉพาะเจาะจง ให้ใช้เมธอด get()
ในทรัพยากร conferenceRecords.participants
ที่มีพารามิเตอร์เส้นทาง name
หากต้องการเรียกข้อมูลชื่อของผู้เข้าร่วม ให้ใช้เมธอด conferenceRecords.participants.list
เมธอดจะแสดงผลชื่อผู้เข้าร่วมเป็นอินสแตนซ์ของทรัพยากรconferenceRecords.participants
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีดึงข้อมูลผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
แทนที่ชื่อผู้เข้าร่วมด้วยชื่อผู้เข้าร่วมที่ต้องการค้นหา
เซสชันของผู้เข้าร่วม
ส่วนต่อไปนี้จะอธิบายรายละเอียดเกี่ยวกับวิธีรับข้อมูลเกี่ยวกับเซสชันของผู้เข้าร่วม
ค้นหาเซสชันของผู้เข้าร่วมทั้งหมด
หากต้องการดูรายละเอียดเกี่ยวกับเซสชันของผู้เข้าร่วมทั้งหมดในบันทึกการประชุม ให้ใช้เมธอด list()
ในทรัพยากร conferenceRecords.participants.participantSessions
ที่มีพารามิเตอร์เส้นทาง parent
คุณสามารถใช้ช่อง 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
เมธอดนี้จะแสดงรายการเซสชันของผู้เข้าร่วม โดยจัดเรียงตามเวลาที่เข้าร่วมจากน้อยไปมาก ในรูปแบบอินสแตนซ์ของทรัพยากร conferenceRecords.participants.participantSession
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีแสดงรายการเซสชันของผู้เข้าร่วมทั้งหมดในระเบียนการประชุม
Java
Node.js
Python
แทนที่ค่าหลักด้วยชื่อระเบียนการประชุมและชื่อผู้เข้าร่วม
ค้นหาเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง
หากต้องการค้นหาเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง ให้ใช้เมธอด get()
ในทรัพยากร conferenceRecords.participants.participantSessions
ที่มีพารามิเตอร์เส้นทาง name
หากต้องการเรียกข้อมูลชื่อของผู้เข้าร่วม ให้ใช้เมธอด list()
เมธอดจะแสดงผลชื่อผู้เข้าร่วมเป็นอินสแตนซ์ของทรัพยากรconferenceRecords.participants.participantSessions
ตัวอย่างโค้ดต่อไปนี้แสดงวิธีเรียกข้อมูลเซสชันของผู้เข้าร่วมที่เฉพาะเจาะจง
Java
Node.js
Python
แทนที่ชื่อผู้เข้าร่วมด้วยชื่อผู้เข้าร่วมที่ต้องการค้นหา
เรียกข้อมูลรายละเอียดผู้เข้าร่วมด้วย People API
หากต้องการเรียกข้อมูลรายละเอียดเกี่ยวกับผู้เข้าร่วม ให้ใช้เมธอด people.get
ใน People API
- ดึงรหัสของบุคคลจากชื่อทรัพยากรของผู้เข้าร่วมโดยใช้คอมโพเนนต์ต่อท้ายของเส้นทาง เช่น หากชื่อทรัพยากรของผู้เข้าร่วมคือ
conferenceRecords/abc-123/participants/12345
รหัสสำหรับ People API จะเป็น12345
- ใส่แหล่งที่มา
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
และREAD_SOURCE_TYPE_OTHER_CONTACT
วิธีนี้ช่วยให้มั่นใจว่าทั้งผู้ใช้ภายในขององค์กร 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