סקירה כללית על Google Meet REST API

ה-API ל-REST של Google Meet מאפשר ליצור ולנהל פגישות ב-Google Meet ומציע נקודות כניסה למשתמשים ישירות מהאפליקציה.

בעזרת ה-API ל-REST של Meet תוכלו:

  • אפשר ליצור מרחב משותף לפגישות כדי לתקשר עם המשתמשים באמצעות וידאו.
  • יצירת מרחב משותף לפגישות או כנסים לפי שם המשאב.
  • לקבל רשימה של המשתתפים והסשנים של המשתתפים.
  • לקבל את פריטי המידע (Artifact) של הפגישה (הקלטות, תמלולים ורשומות של תמלולים).

תוכלו להירשם לאירועים ב-Meet גם באמצעות Google Workspace Event API. תוכלו להירשם למרחב משותף מסוים או לכל חללי הפגישות ששייכים למשתמש מסוים כדי לקבל עדכונים על שינויים. מידע נוסף זמין במאמרים הרשמה לאירועים באמצעות Google Workspace Event API והרשמה לאירועים ב-Google Meet.

תרחישים לדוגמה

אפשר לשלב אפליקציות עם ה-API ל-REST של Meet כדי לבצע את המשימות הבאות:

  • לפני שיחת הוועידה: תוכלו ליצור את המרחב המשותף כדי להתאים את החוויה של שיחת הוועידה לפי הצורך. אפשר גם לנהל את המוזמנים ולקבוע מראש את ההגדרות.

  • במהלך שיחת ועידה: מאחזרים את הפרטים של שיחת הוועידה כדי לשנות את חוויית המשתמש באפליקציה על סמך המטא-נתונים שהוחזרו.

  • אחרי שיחת הוועידה: אחזור של פריטי המידע משיחת הוועידה, כמו ההקלטה והתמלול.

דוגמאות לדברים שאולי תרצו להשתמש ב-Meet REST API בשביל:

  • ניהול מכירות וחשבון

    • אחזור פרטי פגישות ומשתתפים למטרות הקלטה.
    • אחזור של פריטי מידע שנוצרו בתהליך הפגישה ופרסום שלהם בחשבונות.
    • להריץ תמלילים והקלטות באמצעות מודלים של AI כדי ליצור אימון וניתוח של יעילות המכירות.

  • למידה והתפתחות

    • צרו והגדירו מראש פגישות הדרכה.
    • מקצים תפקידים של מארחים נוספים למדריכים ולמנהלי סשנים.
    • אחזור הקלטות כדי לאפשר לתלמידים לעיין בחומרי הלימוד בסיום הקורס.

  • פעולות למפתחים

    • יוצרים פגישות כדי לחבר בין חברי הצוות באופן מיידי.
    • אפשר לאפשר לבעלי עניין אחרים להצטרף לפגישות מתמשכות, על ידי שיתוף מידע על הפגישות בזמן אמת ועל המשתתפים.
    • כדאי להריץ נתוני תמלול באמצעות מודלים של AI כדי ליצור את השלבים הבאים הנכונים.
אתם יכולים ליצור פגישות דינמיות עם העמיתים שלכם במרחב המשותף ב-Chat ולהצטרף אליהן.
איור 1. אתם יכולים ליצור פגישות דינמיות עם העמיתים שלכם במרחב המשותף ב-Chat ולהצטרף אליהן.

אפשר גם לשלב באפליקציה ממשקי API אחרים של Google Workspace, כמו Chat API, כדי לשפר את שיתוף הפעולה עוד יותר. למידע נוסף, ראו תרחישים לדוגמה ב-Chat.

מונחים נפוצים

הרשימה הבאה מפרטת את המונחים הנפוצים ב-API הזה:

פריט מידע שנוצר בתהליך פיתוח (Artifact)
קובץ שנוצר על ידי Meet בתגובה לשיחת ועידה, כמו הקלטות וtranscripts. בדרך כלל פריט מידע שנוצר בתהליך פיתוח (Artifact) מוכן להורדה זמן קצר אחרי ששיחת הוועידה מסתיימת.
אירוע ביומן
אירוע ביומן Google עם כמה משתתפים, שנוצר בדרך כלל על ידי מארגן הפגישה שמכיל את פרטי ההצטרפות לפגישה. Meet עשוי להיות פתרון שיחת ועידה לאירוע.
שיחת טלפון
סשן באמצעות Meet, או כדי להודיע לאחרים על התחלת שיחה או שיחה פעילה ולאפשר להם להצטרף מיד.
שיחת ועידה
שיחת ועידה היא אירוע של שיחה במרחב משותף. המשתמשים בדרך כלל מחשיבים את התרחיש הזה כפגישה אחת.
מארח נוסף
אדם בשיחה שקיבל הרשאות ניהול מארח מהמארח, מלבד היכולת להסיר את המארח המקורי.
מארח
מי שיצר את השיחה (מארגן הפגישה) או מי שמנהל את השיחה. שימו לב: מארגן הפגישה יכול לארגן אותה, אבל לא להיות נוכח בה. בנוסף, המארח יכול להאציל את הרשאות המארח למארח נוסף.
קוד הפגישה
מחרוזת ייחודית של 10 תווים שניתן להקליד עבור מרחב ישיבות, שנעשה בה שימוש בכתובת ה-URL להצטרפות של מרחב משותף מסוים. לדוגמה: abc-mnop-xyz. לא כדאי לשמור קודי פגישות לטווח ארוך כי יכול להיות שהם ינותקו ממרחבי ישיבות, ואפשר יהיה להשתמש בהם שוב בחדרי ישיבות שונים בעתיד. בדרך כלל, התוקף של קוד הפגישה פג 365 יום אחרי השימוש האחרון בו. למידע נוסף, תוכלו לקרוא את המאמר מידע על קודים של פגישות ב-Google Meet.
שם הפגישה
מזהה ייחודי שנוצר על ידי השרת ומשמש לזיהוי מרחבי ישיבות. מזהה הפגישה מוחזר בשדה name של משאב spaces
.
מארגן הפגישה
המשתמש שיצר את מרחב הפגישות. גם המשתמש הזה יכול להיחשב כבעלים של הפגישה. יכול להיות שהם לא יהיו נוכחים במהלך השיחה או שהם המארחים של הפגישה. לכל פגישה יכול להיות רק מארגן אחד.
מרחב לפגישות
מקום וירטואלי או אובייקט קבוע (כמו חדר ישיבות) שבו מתקיימת כנס. אפשר לקיים רק שיחת ועידה פעילה אחת במרחב משותף בכל רגע נתון. בנוסף, הם עוזרים למשתמשים להיפגש ולמצוא משאבים משותפים.
משתתף
מישהו הצטרף לשיחה, שמשתמש במצב Companion, צופה בצפייה או ממכשיר בחדר שמחובר לשיחה. לכל משתמש יש משאב conferenceRecords.participants אחד. בכל פעם שמשתתף מצטרף לשיחת ועידה, מוקצה מזהה ייחודי.
סשן של משתתף
המערכת יוצרת מזהה סשן ייחודי לכל צמד של משתתף ומכשיר שמצטרף לשיחה. לכל סשן יש משאב conferenceRecords.participants.participantSessions אחד. אם המשתתף מצטרף לאותה שיחה כמה פעמים מאותו צמד של משתתף ומכשיר, לכל אחד מהם מוקצים מזהה סשן ייחודי.

פרטי הרשאה ואימות ספציפיים ל-API

היקפי ההרשאות הם ההרשאות שאתם מבקשים מהמשתמשים לאשר לאפליקציה שלכם לגשת לתוכן של הפגישה. כשמשתמש יתקין את האפליקציה, המשתמש מתבקש לאמת את ההיקפים האלה. באופן כללי, כדאי לבחור בהיקף הכי ממוקד שאפשר ולהימנע מבקשות להיקפים לא נדרשים לאפליקציה. המשתמשים מעניקים גישה להיקפים מוגבלים ומתוארים בצורה ברורה יותר.

Meet ל-REST API תומך בהיקפי ההרשאות הבאים של OAuth 2.0:

קוד ההיקף תיאור Usage
https://www.googleapis.com/auth/meetings.space.readonly מתן הרשאה לאפליקציות לקרוא מטא-נתונים על כל מרחב משותף ב-Meet שאליו יש למשתמש גישה. רגישות
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.