במדריך הזה נסביר איך לקבל פרטים על משתתפים שהשתתפו בפגישה קודמת או על משתתפים בפגישה פעילה, יחד עם פרטי הסשן שלהם, באמצעות ה-API ל-REST של Google Meet.
משתתף הוא אדם שהצטרף לשיחה, משתמש במצב Companion, צופה כצופה או מכשיר בחדר שמחובר לשיחה. יש משאב participants
אחד לכל אדם.
סשן של משתתף הוא מזהה סשן ייחודי שנוצר לכל צמד של משתתף ומכשיר שמצטרפים לשיחה.
יש משאב participantSessions
אחד לכל סשן. אם המשתתף מצטרף לאותה שיחה כמה פעמים מאותו צמד משתתף-מכשיר, לכל אחד מהם יוקצה מזהה סשן ייחודי.
אם אתם הבעלים של מרחב משותף לפגישות או משתתפים בו, אתם יכולים להפעיל את השיטות get()
ו-list()
במשאבים participants
ו-participantSessions
כדי לאחזר רשומות של משתתפים.
אימות והרשאה באמצעות פרטי כניסה של משתמשים מאפשרים לאפליקציות של Google Meet לגשת לנתוני המשתמשים ולבצע פעולות בשם המשתמש המאומת. אימות באמצעות הענקת גישה ברמת הדומיין מאפשר לתת הרשאה לחשבון השירות של האפליקציה לגשת לנתונים של המשתמשים בלי לחייב כל משתמש לתת הסכמה.
משתתפים
בקטעים הבאים מוסבר איך לקבל מידע על המשתתפים בתיעוד של כנס.
participants
משאבים מאיחודים עם השדה user
. הערך של user
יכול להיות רק אחד מהאובייקטים הבאים:
signedinUser
יכול להיות:משתמש שמצטרף לפגישה ממחשב אישי, ממכשיר נייד או דרך מצב Companion.
חשבון רובוט שמשמש מכשירים בחדר ישיבות.
anonymousUser
הוא משתמש לא מזוהה שלא מחובר לחשבון Google.phoneUser
הוא משתמש שמצטרף באמצעות טלפון, והזהות שלו לא ידועה כי הוא לא נכנס לחשבון Google.
שימו לב: כל שלושת האובייקטים מחזירים ערך של displayName
, אבל signedinUser
מחזיר גם מזהה user
ייחודי שתואם ל-Admin SDK API ול-People API. פורמט: users/{user}
. מידע נוסף על השימוש במזהה user
עם People API זמין במאמר אחזור פרטי המשתתפים באמצעות People API.
הצגת פרטים על משתתף
כדי לקבל פרטים על משתתף ספציפי, משתמשים ב-method get()
במשאב participants
עם פרמטר הנתיב name
. אם אתם לא יודעים את שם המשתתף, תוכלו לציין את כל שמות המשתתפים באמצעות השיטה list()
.
השיטה מחזירה את נתוני המשתתפים כמכונה של משאב participants
.
דוגמת הקוד הבאה מראה איך לאחזר משתתף ספציפי:
Java
Node.js
Python
מחליפים את שם המשתתף בשם של מזהה המשתתף הספציפי ברשומת של הכינוס.
הצגת רשימת כל המשתתפים
כדי לקבל רשימה של פרטים על כל המשתתפים ברשומת ועידה, משתמשים ב-method list()
במשאב participants
עם פרמטר הנתיב parent
. פורמט:
conferenceRecords/{conferenceRecord}
.
השיטה מחזירה רשימה של משתתפי הפגישה, שממוינים לפי earliestStartTime
בסדר יורד, כמכונה של משאב participants
. במאמר התאמה אישית של החלוקה לדפים או סינון של רשימת המשתתפים מוסבר איך לשנות את גודל הדף ולסנן את תוצאות השאילתה.
בדוגמת הקוד הבאה מוסבר איך להציג את כל המשתתפים בפרוטוקול של פגישה:
Java
Node.js
Python
מחליפים את ערך ההורה בשם של רשומת הכינוס.
התאמה אישית של חלוקת הדפים או סינון של רשימת המשתתפים
כדי להתאים אישית את החלוקה לדפים של המשתתפים או לסנן אותם, מעבירים את הפרמטרים הבאים של השאילתה:
pageSize
: מספר המשתתפים המקסימלי שצריך להחזיר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מצוין, יוחזרו עד 100 משתתפים. הערך המקסימלי הוא 250. ערכים גבוהים מ-250 משתנים אוטומטית ל-250.pageToken
: טוקן דף, שהתקבל מבקשת רשימה קודמת. צריך לספק את האסימון הזה כדי לאחזר את הדף הבא.
filter
: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של המשאבparticipants
.אפשר להשתמש בשדות
earliestStartTime
אוlatestEndTime
כדי לסנן משתמשים שהצטרפו לפני זמן מסוים או עזבו אחרי זמן מסוים. בשני השדות נעשה שימוש בפורמט חותמת זמן בפורמט 'Zulu' של 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
.
אחזור פרטי המשתתפים באמצעות People API
כדי לאחזר פרטים על משתתף, משתמשים בשיטה get()
במשאב people
ב-People API.
מחלצים את המזהה של האדם מהמשאב
participant
באמצעות הרכיב העוקב של הנתיב. לדוגמה, אם הערך של המשאבparticipant
הואconferenceRecords/abc-123/participants/12345
, המזהה של People API הוא12345
.כולל את
READ_SOURCE_TYPE_PROFILE
,READ_SOURCE_TYPE_CONTACT
ו-READ_SOURCE_TYPE_OTHER_CONTACT
ReadSourceType
. כך תוכלו לוודא שגם משתמשים פנימיים בארגון ב-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
מחליפים את מה שכתוב בשדות הבאים:
- PERSON_ID: המזהה של האדם שרוצים למצוא.
- ACCESS_TOKEN: טוקן הגישה שמעניק גישה למספר ממשקי API.
סשנים של משתתפים
בקטעים הבאים מוסבר איך לקבל מידע על סשנים של משתתפים ברשומת ועידה.
הצגת פרטים על סשן של משתתף
כדי לקבל פרטים על סשן של משתתף ספציפי, משתמשים ב-method get()
במשאב participantSessions
עם פרמטר הנתיב name
. אם אתם לא יודעים את שם הסשן של המשתתף, תוכלו לציין את כל הסשנים של המשתתף באמצעות השיטה list()
.
השיטה מחזירה את שם המשתתף כמכונה של משאב participantSessions
.
דוגמת הקוד הבאה מראה איך לאחזר סשן של משתתף ספציפי:
Java
Node.js
Python
מחליפים את שם המשתתף בשם של מזהה הסשן הספציפי של המשתתף בסשן של המשתתף.
הצגת רשימה של כל הסשנים של המשתתפים
כדי לקבל רשימה של פרטים על כל הסשנים של משתתף מסוים בתיעוד של ועידה, משתמשים ב-method list()
במשאב participantSessions
עם פרמטר הנתיב parent
. פורמט:
conferenceRecords/{conferenceRecord}/participants/{participant}
.
השיטה מחזירה רשימה של סשנים של משתתפים, שממוינים לפי startTime
בסדר יורד, כמכונה של משאב participantSession
. במאמר התאמה אישית של חלוקה לדפים או סינון של רשימת הסשנים של המשתתפים מוסבר איך לשנות את גודל הדף ולסנן את תוצאות השאילתה.
בדוגמת הקוד הבאה מוסבר איך להציג רשימה של כל הסשנים של המשתתפים ברשומת ועידה:
Java
Node.js
Python
מחליפים את ערך ההורה בשם של סשנים של משתתפים של משתתף ברשומת ועידה.
התאמה אישית של החלוקה לדפים או סינון של רשימת הסשנים של המשתתפים
כדי להתאים אישית את החלוקה לדפים של סשנים של משתתפים או לסנן אותם, מעבירים את הפרמטרים האופציונליים הבאים של השאילתה:
pageSize
: מספר הסשנים המקסימלי של משתתפים שצריך להחזיר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת מחזירה עד 100 סשנים של משתתפים. הערך המקסימלי הוא 250. ערכים גבוהים מ-250 משתנים באופן אוטומטי ל-250.pageToken
: טוקן דף, שהתקבל מבקשת רשימה קודמת. צריך לספק את האסימון הזה כדי לאחזר את הדף הבא.
filter
: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של המשאבparticipants
.אפשר להשתמש בשדות
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
כדי להציג את כל הסשנים הפעילים של המשתתפים בתיעוד של ישיבת הוועידה, משתמשים ב-
endTime IS NULL
.