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