במדריך הזה מוסבר איך לקבל פרטים על משתתפים שהשתתפו בעבר בשיחות ועידה או שמשתתפים בשיחות ועידה פעילות, וגם את פרטי הסשן שלהם, באמצעות Google Meet REST API.
משתתף הוא אדם שהצטרף לשיחה או שמשתמש במצב 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.
איך מקבלים פרטים על משתתף
כדי לקבל פרטים על משתתף ספציפי, משתמשים בשיטה get()
במשאב participants
עם פרמטר הנתיב name
. אם אתם לא יודעים את שם המשתתף, אתם יכולים לרשום את כל שמות המשתתפים באמצעות השיטה list()
.
השיטה מחזירה נתוני משתתפים כמופע של משאב participants
.
דוגמת הקוד הבאה מראה איך לאחזר משתתף ספציפי:
Java
Node.js
Python
מחליפים את שם המשתתף בשם של מזהה המשתתף הספציפי ברשומה של שיחת ועידה.
הצגת רשימה של כל המשתתפים
כדי לפרט את כל המשתתפים ברשומה של שיחת ועידה, משתמשים בשיטה list()
במשאב participants
עם פרמטר הנתיב parent
. פורמט:
conferenceRecords/{conferenceRecord}
.
השיטה מחזירה רשימה של משתתפים בוועידה, מסודרת לפי earliestStartTime
בסדר יורד, כמופע של משאב participants
. כדי לשנות את גודל הדף ולסנן את תוצאות השאילתה, אפשר לעיין במאמר התאמה אישית של מספור הדפים או סינון רשימת המשתתפים.
בדוגמת הקוד הבאה מוצגת רשימה של כל המשתתפים בהקלטה של ועידה:
Java
Node.js
Python
מחליפים את ערך ההורה בשם של רשומת הוועידה.
התאמה אישית של מספור הדפים או סינון רשימת המשתתפים
מעבירים את הפרמטרים הבאים של השאילתה כדי להתאים אישית את המספור של המשתתפים או לסנן אותם:
pageSize
: המספר המקסימלי של משתתפים שיוחזר. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מצוין, יוחזרו לכל היותר 100 משתתפים. הערך המקסימלי הוא 250. ערכים שגדולים מ-250 משתנים אוטומטית ל-250.
pageToken
: טוקן דף שהתקבל מקריאה קודמת של רשימה. צריך לספק את האסימון הזה כדי לאחזר את הדף הבא.
filter
: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של משאבparticipants
.אפשר להשתמש בשדות
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
.
אחזור פרטי משתתפים באמצעות 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
כדי לסנן משתמשים שהצטרפו לפני זמן מסוים או עזבו אחרי זמן מסוים. בשני השדות האלה משתמשים בפורמט חותמת זמן בפורמט 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
.