ה-API ל-REST של Google Meet מאפשר ליצור ולנהל פגישות ל-Google Meet ומציע נקודות כניסה למשתמשים ישירות מהאפליקציה.
כשמשתמשים ב-API ל-REST של Meet, אפשר:
- אפשר ליצור מרחב לפגישות כדי לחבר בין משתמשים באמצעות וידאו.
- ליצור מרחב לפגישה או שיחת ועידה לפי שם המשאב.
- לקבל רשימה של המשתתפים והסשנים של המשתתפים.
- מקבלים את תוצרי הפגישות (הקלטות, תמלילים ותמלילים).
אפשר להירשם לאירועים ב-Meet גם באמצעות Google Workspace Event API. כדי לקבל עדכונים על שינויים, תוכלו להירשם למרחב ישיבות ספציפי או לכל המרחבים המשותפים ששייכים למשתמש מסוים. מידע נוסף זמין במאמרים הרשמה לאירועים באמצעות Google Workspace Event API והרשמה לאירועים ב-Google Meet.
תרחישים לדוגמה
אפשר לשלב אפליקציות עם API ל-REST של Meet כדי לבצע את המשימות הבאות:
לפני שיחת הוועידה: תוכלו ליצור את מרחב הישיבות כדי לשנות את חוויית השימוש בו לפי הצורך. אפשר גם לנהל את המוזמנים ולקבוע מראש את ההגדרות.
במהלך שיחת ועידה: אחזור הפרטים של שיחת הוועידה כדי לשנות את חוויית השימוש באפליקציה על סמך המטא-נתונים שהוחזרו.
אחרי שיחת ועידה: אחזור פריטי מידע של שיחת הוועידה, כמו ההקלטה והתמלול.
דוגמאות לדברים שכדאי להשתמש בהם ב-API ל-REST של Meet:
מכירות וניהול החשבון
- אחזור פרטי פגישות ומשתתפים למטרות תיעוד.
- לאחזר את תוצרי הפגישות ולפרסם אותם בחשבונות.
- אפשר להריץ תמלילים והקלטות באמצעות מודלים של AI כדי ליצור אימון וניתוח של יעילות המכירות.
למידה ופיתוח
- יצירה והגדרה מראש של פגישות לאימון.
- להקצות תפקידים של מארחים נוספים למדריכים וללידים בסשנים.
- אחזור הקלטות כדי לאפשר לתלמידים לעיין בחומרי הלימוד אחרי שהקורס מסתיים.
פעולות למפתחים
- אפשר ליצור פגישות כדי לחבר בין חברי צוות באופן מיידי.
- לאפשר לבעלי עניין אחרים להצטרף לפגישות פעילות על ידי שיתוף מידע על הפגישות בזמן אמת ועל פרטי המשתתפים.
- אפשר להריץ נתוני תמלול באמצעות מודלים של AI כדי ליצור את השלבים הבאים.
אתם גם יכולים לשלב באפליקציה שלכם ממשקי API אחרים של Google Workspace, כמו Chat API, כדי לשפר עוד יותר את שיתוף הפעולה. מידע נוסף מופיע במאמר תרחישים לדוגמה ב-Chat.
מונחים נפוצים
לפניכם רשימה של המונחים הנפוצים שנמצאים בשימוש ב-API הזה:
- ארטיפקט
- קובץ שנוצר על ידי Meet בתגובה לשיחת ועידה, כמו הקלטות וtranscripts. בדרך כלל פריט מידע שנוצר בתהליך פיתוח (Artifact) מוכן לאחזור זמן קצר אחרי ששיחת הוועידה מסתיימת.
- אירוע ביומן
- אירוע ביומן Google עם כמה משתתפים, שנוצר בדרך כלל על ידי מארגן הפגישה, ומכיל את פרטי ההצטרפות לפגישה. Meet עשוי להיות הפתרון לשיחות ועידה.
- שיחת טלפון
- סשן באמצעות Meet, או כדי להודיע לאחרים על התחלת או שיחה של שיחה, ולאפשר להם להצטרף מיד.
- שיחת ועידה
- שיחת ועידה היא מופע של שיחה בתוך מרחב ישיבות. המשתמשים בדרך כלל מתייחסים לתרחיש הזה כפגישה אחת.
- מארחים נוספים
- אדם בשיחה שקיבל הרשאות ניהול מארחים ממארח, מלבד יכולת להסיר את המארח המקורי.
- מארח
- מי שיצר את השיחה (מארגן הפגישה) או מי ששולט בשיחה. שימו לב שמארגן הפגישה יכול לארגן את הפגישה, אבל לא להיות נוכח בה. גם המארחים יכולים לתת למארחים נוספים הרשאות גישה למארח.
- קוד הפגישה
מחרוזת ייחודית באורך 10 תווים שאפשר להקליד עבור המרחב לפגישה, בתוך ה-URI של הפגישה של מרחב ישיבות. הפורמט לא תלוי אותיות רישיות (case-sensitive). לדוגמה:
abc-mnop-xyz. האורך המקסימלי הוא 128 תווים.אין לשמור את קודי הפגישות לתקופה ארוכה, כי הם יכולים להיות מנותקים מהמרחב המשותף ולעשות בהם שימוש חוזר במרחבים משותפים שונים. בדרך כלל, התוקף של קוד פגישה פג 365 יום לאחר השימוש האחרון בו. מידע נוסף מופיע במאמר הסבר על קודי פגישות ב-Google Meet.
- שם הפגישה
מזהה ייחודי שנוצר על ידי השרת שמשמש לזיהוי מרחב לפגישות. הוא תלוי אותיות רישיות. לדוגמה:
jQCFfuBOdN5z. מזהה הפגישה מוחזר בשדהnameבמשאבspaces.- מארגן הפגישה
המשתמש שיצר את מרחב הפגישה. המשתמש הזה יכול גם להיחשב כבעלים של הפגישה. יכול להיות שהם לא נמצאים במהלך השיחה או שהם המארחים של הפגישה. יכול להיות רק מארגן אחד לפגישה.
- מרחבים משותפים לפגישות
מקום וירטואלי או אובייקט קבוע (כמו חדר ישיבות) שבו מתקיימת כנס. אפשר לקיים רק שיחת ועידה פעילה אחת במרחב משותף אחד בכל רגע נתון. מרחב הישיבות גם עוזר למשתמשים לפגוש משאבים משותפים ולמצוא אותם.
- URI של הפגישה
כתובת URL שניתן ללחוץ עליה, שמתחילה בשיחה או מצרפת את המשתמש אליה. לכל שיחה יש כתובת URL ייחודית שמורכבת מ-
https://meet.google.com/ואחריה קוד הפגישה. לדוגמה,https://meet.google.com/abc-mnop-xyz.- משתתף
מי שהצטרף לשיחה או משתמש במצב Companion וצופה בשיחה או משתמש בחדר שמחובר לשיחה. לכל משתמש יש משאב אחד ב-
conferenceRecords.participants. כשמשתתף מצטרף לשיחת הוועידה, מוקצה מזהה ייחודי.- סשן של משתתפים
מזהה סשן ייחודי שנוצר לכל צמד של משתתף-מכשיר שמצטרף לשיחה. לכל סשן יש משאב אחד ב-
conferenceRecords.participants.participantSessions. אם המשתתף מצטרף לאותה שיחה כמה פעמים מאותו זוג של משתתף-מכשיר, לכל אחד מהם מוקצים מזהי סשנים ייחודיים.
מידע ספציפי על הרשאות ואימות ל-API
היקפי הרשאות הם ההרשאות שאתם מבקשים מהמשתמשים לתת לאפליקציה שלכם כדי לגשת לתוכן הפגישה. כשמשתמש מתקין את האפליקציה, המשתמש מתבקש לאמת את היקפי ההרשאות האלה. באופן כללי, כדאי לבחור את ההיקף הצר ביותר שאפשר ולהימנע משליחת בקשות להיקפים שלא נדרשים לאפליקציה. משתמשים מעניקים גישה מהירה יותר להיקפים מוגבלים שמתארים בצורה ברורה.
ב-API ל-REST של Meet יש תמיכה בהיקפי ההרשאות הבאים של OAuth 2.0:
| קוד היקף ההרשאות | תיאור | Usage |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.readonly |
אפליקציות יכולות לקרוא מטא-נתונים על כל מרחב ישיבות שלמשתמש יש גישה אליו. | רגישות |
https://www.googleapis.com/auth/meetings.space.created |
ההגדרה הזו מאפשרת לאפליקציות ליצור, לשנות ולקרוא מטא-נתונים על חדרי ישיבות שהאפליקציה יצרה. | רגישות |
https://www.googleapis.com/auth/drive.readonly |
אפליקציות יכולות להוריד קובצי הקלטה ותמלול מ-Google Drive API. | מוצר שהצפייה בו הוגבלה |
למידע נוסף על היקפים ספציפיים של OAuth 2.0, ראו היקפי OAuth 2.0 ל-Google APIs.
נושאים קשורים
למידע נוסף על הפיתוח עם Google Workspace APIs, כולל הטיפול באימות ובהרשאה, קראו את המאמר פיתוח ב-Google Workspace.
במדריך עבודה עם מרחבי ישיבות מוסבר איך יוצרים מרחב ישיבות באמצעות ה-API ל-REST של Meet.
במאמר הרשמה לאירועים באמצעות Google Workspace Event API מוסבר איך נרשמים לאירועים ב-Google Workspace.