ผู้เข้าร่วมคือบุคคลที่เข้าร่วมกิจกรรม
การโทรหรือใช้โหมดแยกหน้าจอประชุม
รับชมในฐานะผู้ชม หรือ
อุปกรณ์ในห้องที่เชื่อมต่อกับการโทร มี 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