במדריך הזה מוסבר איך לקבל פרטים על משתתפים שהשתתפו בעבר בשיחות ועידה או שמשתתפים בשיחות ועידה פעילות, וגם פרטים על הסשן שלהם, באמצעות Google Meet API בארכיטקטורת REST.
משתתף הוא אדם שהצטרף לשיחה או שמשתמש במצב 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 בפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
אם אתם לא יודעים את שם המשתתף, אתם יכולים לרשום את כל שמות המשתתפים באמצעות השיטה list.
השיטה מחזירה נתוני משתתפים כמופע של משאב participants.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים משתתף ספציפי:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את מה שכתוב בשדות הבאים:
- שם רשומת שיחת הוועידה עם השם של מזהה שיחת הוועידה הספציפי ברשומת שיחת ועידה.
- שם המשתתף עם השם של מזהה המשתתף הספציפי ברשומה של הוועידה.
הצגת רשימה של כל המשתתפים
כדי לראות את הפרטים של כל המשתתפים בהקלטה של שיחת ועידה, משתמשים בשיטה list במשאב participants. מגדירים את פרמטר הנתיב parent בפורמט conferenceRecords/{conferenceRecord}.
השיטה מחזירה רשימה של משתתפים בוועידה, מסודרת לפי earliestStartTime בסדר יורד, כמופע של משאב participants. כדי לשנות את גודל הדף ולסנן את תוצאות השאילתה, אפשר לעיין במאמר התאמה אישית של מספור הדפים או סינון רשימת המשתתפים.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל המשתתפים בהקלטה של שיחת ועידה:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/PARENT_NAME/participants" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את שם ההורה בשם של מזהה שיחת הוועידה הספציפי ברשומה של הוועידה.
התאמה אישית של מספור העמודים או סינון רשימת המשתתפים
מעבירים את פרמטרי השאילתה הבאים כדי להתאים אישית את החלוקה לדפים של המשתתפים או לסנן אותם:
pageSize: המספר המקסימלי של המשתתפים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו לכל היותר 100 משתתפים. הערך המקסימלי הוא 250. ערכים שגדולים מ-250 משתנים אוטומטית ל-250.
pageToken: טוקן של דף שהתקבל מקריאה קודמת של רשימה. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.
filter: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של משאבparticipants.אתם יכולים להשתמש בשדות
earliestStartTimeאוlatestEndTimeכדי לסנן משתמשים שהצטרפו לפני זמן מסוים או עזבו אחרי זמן מסוים. בשני השדות האלה משתמשים בפורמט Timestamp בפורמט RFC 3339 UTC 'Zulu', עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה העשרונית:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. לדוגמה:earliestStartTime < 2023-10-01T15:01:23ZlatestEndTime < 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_CONTACTReadSourceType. כך תוכלו לוודא שהתשובה תכלול גם משתמשים פנימיים בארגון 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.
סשנים של משתתפים
בקטעים הבאים מוסבר איך לקבל מידע על סשנים של משתתפים בהקלטה של שיחת ועידה.
איך רואים פרטים על סשן של משתתף
כדי לקבל פרטים על סשן של משתתף ספציפי, משתמשים בשיטה get במשאב participantSessions. מגדירים את פרמטר הנתיב name בפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}/participantSessions/{participantSessionRecord}.
אם אתם לא יודעים את שם הסשן של המשתתף, אתם יכולים לרשום את כל הסשנים של המשתתף באמצעות השיטה list.
השיטה מחזירה את שם המשתתף כמופע של משאב participantSessions.
בדוגמת הקוד הבאה אפשר לראות איך מאחזרים סשן ספציפי של משתתף:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARTICIPANT_NAME/participantSessions/PARTICIPANT_SESSION_ID" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את מה שכתוב בשדות הבאים:
- שם רשומת שיחת הוועידה עם השם של מזהה שיחת הוועידה הספציפי ברשומת שיחת ועידה.
- שם המשתתף עם השם של מזהה המשתתף הספציפי ברשומה של הוועידה.
- מזהה הסשן של המשתתף עם המזהה של הסשן הספציפי של המשתתף.
הצגת רשימה של כל הסשנים של המשתתפים
כדי לראות את הפרטים של כל הסשנים של משתתף בהקלטה של שיחת ועידה, משתמשים בשיטה list() במשאב participantSessions. מגדירים את פרמטר הנתיב parent בפורמט conferenceRecords/{conferenceRecord}/participants/{participantRecord}.
השיטה מחזירה רשימה של סשנים של משתתפים, מסודרים לפי startTime בסדר יורד, כמופע של משאב participantSession. כדי לשנות את גודל הדף ולסנן את תוצאות השאילתה, אפשר לעיין במאמר בנושא התאמה אישית של חלוקה לדפים או סינון של רשימת הסשנים של המשתתפים.
בדוגמת הקוד הבאה אפשר לראות איך מציגים רשימה של כל הסשנים של המשתתפים ברשומה של שיחת ועידה:
Java
Node.js
Python
cURL
curl -X GET "https://meet.googleapis.com/v2/conferenceRecords/CONFERENCE_RECORD_NAME/participants/PARENT_NAME/participantSessions" \
-H "Authorization: Bearer ACCESS_TOKEN"
מחליפים את ACCESS_TOKEN באסימון הגישה שמעניק גישה ל-API.
מחליפים את מה שכתוב בשדות הבאים:
- שם רשומת שיחת הוועידה עם השם של מזהה שיחת הוועידה הספציפי ברשומת שיחת ועידה.
- שם ההורה עם שם המשתתף בסשנים של משתתף ברשומה של שיחת ועידה.
התאמה אישית של חלוקה לדפים או סינון של רשימת הסשנים של המשתתפים
אפשר להעביר את הפרמטרים האופציונליים הבאים של השאילתה כדי להתאים אישית את החלוקה לדפים או לסנן את הסשנים של המשתתפים:
pageSize: המספר המקסימלי של סשנים של משתתפים שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, יוחזרו לכל היותר 100 סשנים של משתתפים. הערך המקסימלי הוא 250. ערכים גבוהים מ-250 ישתנו אוטומטית ל-250.
pageToken: טוקן של דף שהתקבל מקריאה קודמת של רשימה. צריך להזין את הטוקן הזה כדי לאחזר את הדף הבא.
filter: אופציונלי. מסנן שאילתה לאחזור פריטים ספציפיים בתוצאות של משאבparticipants.אפשר להשתמש בשדות
startTimeאוendTimeכדי לסנן משתמשים שהצטרפו לפני זמן מסוים או עזבו אחרי זמן מסוים. בשני השדות האלה משתמשים בפורמט Timestamp בפורמט RFC 3339 UTC 'Zulu', עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה העשרונית:{year}-{month}-{day}T{hour}:{min}:{sec}[.{frac_sec}]Z. לדוגמה:startTime < 2023-10-01T15:01:23ZendTime < 2023-10-01T15:01:23Z
כדי להציג רשימה של כל הסשנים הפעילים של המשתתפים ברשומה של שיחת הוועידה, משתמשים בפקודה
endTime IS NULL.