משתתף הוא אדם שמחובר אל
או שמשתמשת ב-Companion
במצב הנוכחי, צפייה כצופה,
מכשיר שמחובר לשיחה. יש משאב conferenceRecords.participants
אחד לכל אדם.
סשן של משתתף הוא
מזהה סשן ייחודי שנוצר לכל צמד של משתתף-מכשיר שמצטרף לשיחה.
יש אחד
conferenceRecords.participants.participantSessions
עבור כל פעילות באתר. אם המשתתף מצטרף לאותה שיחה כמה פעמים
מאותו זוג של משתתף-מכשיר, לכל אחד מהם מוקצים מזהי סשנים ייחודיים.
בדף הזה נסביר איך לקבל מידע על כל המשתתפים שנכחו או נמצאים בשיחת ועידה, או על משתתף יחיד, יחד עם פרטי הסשן שלו.
משתתפים
בקטעים הבאים מוסבר איך לקבל מידע על המשתתפים.
conferenceRecords.participants
המשאב כולל את השדה user
. user
יכול להיות רק אחד מהערכים הבאים
אובייקטים:
signedinUser
היא:אדם שמצטרף ממחשב אישי, ממכשיר נייד דרך מצב Companion.
חשבון רובוטי שמשמש מכשירים לחדרי ישיבות.
anonymousUser
הוא משתמש בלתי מזוהה שלא מחובר לחשבון Google.phoneUser
הוא משתמש שמצטרף באמצעות טלפון, והזהות שלו לא ידועה כי הוא לא נכנס לחשבון Google.
חיפוש כל המשתתפים
כדי לקבל פרטים על כל המשתתפים בהקלטה של שיחת הוועידה, תוכלו להשתמש
list()
ב-method
conferenceRecords.participants
משאב עם פרמטר הנתיב parent
.
אפשר לסנן לפי השדות earliestStartTime
או latestEndTime
משתמשים שהצטרפו לפני או אחרי פרק זמן מסוים. בשני השדות נעשה שימוש בפורמט חותמת זמן בפורמט RFC 3339 UTC 'Zulu', עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות:
{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()
ב-method
conferenceRecords.participants
משאב עם פרמטר הנתיב name
. כדי לאחזר את השם של
משתתף, יש להשתמש בשיטה conferenceRecords.participants.list
.
השיטה מחזירה שם של משתתף כמופע של
משאב conferenceRecords.participants
.
דוגמת הקוד הבאה מראה איך מאחזרים משתתף ספציפי:
Java
Node.js
Python
מחליפים את שם המשתתף בשם של המשתתף הספציפי שרוצים לחפש.
סשנים של משתתפים
בחלקים הבאים מוסבר איך לקבל מידע על סשנים של משתתפים.
חיפוש כל הסשנים של המשתתפים
לקבל פרטים על כל הסשנים של המשתתפים בשיחת הוועידה
להקליט, משתמשים
list()
ב-method
conferenceRecords.participants.participantSessions
משאב עם פרמטר הנתיב parent
.
אפשר להשתמש בשדות startTime
או endTime
כדי לסנן משתמשים שהצטרפו לפני זמן מסוים או עזבו אחרי זמן מסוים. שני השדות משתמשים באופרטור
חותמת זמן
פורמט ב-RFC
3339 לפי שעון UTC
'זולו' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות:
{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()
ב-method
conferenceRecords.participants.participantSessions
משאב עם פרמטר הנתיב name
. כדי לאחזר את שם המשתתף, משתמשים בשיטה list()
.
השיטה מחזירה שם של משתתף כמופע של
משאב conferenceRecords.participants.participantSessions
.
דוגמת הקוד הבאה מראה איך מאחזרים סשן ספציפי של משתתף:
Java
Node.js
Python
מחליפים את שם המשתתף בשם של המשתתף הספציפי שרוצים לחפש.
אחזור פרטי משתתפים באמצעות People API
כדי לאחזר פרטים על משתתף, אפשר להשתמש
השיטה people.get
People API.
- מחלצים את המזהה של המשתתף משם המשאב של המשתתף באמצעות הרכיב העוקב של הנתיב. לדוגמה, אם שם המשאב של המשתתף
הוא
conferenceRecords/abc-123/participants/12345
המזהה של ממשק ה-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