משתתף הוא אדם שמחובר אל
או שמשתמשת ב-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 "זולו" בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות:
{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