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

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

בעזרת API בארכיטקטורת REST של Meet, אתם יכולים:

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

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

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

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

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

  • במהלך שיחת ועידה: אחזור של מטא-נתונים פעילים של שיחת הוועידה ושל סשנים של משתתפים, ניהול דינמי של משתתפים, האזנה לאירועים בזמן אמת של מחזור החיים באמצעות Google Workspace Events API, או סיום תוכניתי של שיחת הוועידה הפעילה.

  • אחרי ועידה: אפשר לאחזר הקלטות של ועידות ויומני נוכחות, להוריד הקלטות, תמלילים של Google Docs והערות חכמות מ-Google Drive, ולגשת לרשומות מפורטות של דיבור בתמליל לצורך אימון, תאימות או ניתוח באמצעות AI.

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

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

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

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

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

  • תמיכת לקוחות וייעוץ

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

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

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

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

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

ריכזנו כאן רשימה של מונחים נפוצים שמופיעים ב-API הזה:

ועידה פעילה
הכנס שמתקיים בחלל הפגישות. בכל רגע נתון יכולה להתקיים רק שיחת ועידה פעילה אחת במרחב לפגישות. אחרי שהיא מסתיימת, היא הופכת לתיעוד היסטורי של שיחת הוועידה.
Artifact
קובץ שנוצר על ידי Meet בתגובה לשיחת ועידה, כמו recordings, transcripts וsmartNotes. הפריטים שנוצרו מהפגישה נשמרים ב-Drive של מארגן הפגישה. בדרך כלל אפשר לאחזר אותם זמן קצר אחרי שהשיחה מסתיימת.
אירוע ביומן
אירוע ביומן Google עם כמה משתתפים, שבדרך כלל נוצר על ידי מארגן הפגישה, ומכיל את פרטי ההצטרפות לפגישה. יכול להיות ש-Meet הוא הפתרון לכנס של האירוע.
שיחת טלפון
להתחיל סשן ב-Meet, או להודיע לאנשים אחרים שהשיחה מתחילה או בעיצומה ולאפשר להם להצטרף מיד.
מארח משני
אדם בשיחה שמארח העניק לו הרשאות ניהול של המארח, למעט היכולת להסיר את המארח המקורי.
ועידה
ועידה היא מופע של שיחה במרחב פגישות. משתמשים בדרך כלל רואים בתרחיש הזה פגישה אחת.
המאזן בתוך האזור
מזהה ייחודי לכל מופע של שיחת ועידה. הוא נוצר באופן אוטומטי כשהשיחה מתחילה. המשאב conferenceRecords משתמש בפורמט conferenceRecords/{conferenceRecord}. לדוגמה, conferenceRecords/kRyYx8b7vNDsLpR1tG_cNjFUQBoBRhHIMoGJAJkBCQ.
הצטרפות באמצעות הטלפון
כדי להשתמש בטלפון כדי להשתתף בשיחה או כדי להאזין לשיחה שמועברת בסטרימינג.
מארח
מי שיצר את השיחה (מארגן הפגישה) או מי ששולט בשיחה. חשוב לזכור שמארגן הפגישה יכול לארגן את הפגישה אבל לא להיות נוכח כשהיא מתקיימת. המארח יכול גם להעביר את הרשאות המארח למארח נוסף.
קוד הפגישה

מחרוזת ייחודית בת 10 תווים שאפשר להקליד בשביל מרחב לפגישה, ומשמשת במזהה ה-URI של המרחב לפגישה. הוא לא תלוי אותיות רישיות (case-sensitive). לדוגמה: abc-mnop-xyz. האורך המקסימלי הוא 128 תווים.

לא מומלץ לאחסן קודי פגישות לטווח ארוך, כי הם עלולים להתנתק מהמרחב של הפגישה, ואפשר יהיה להשתמש בהם שוב בעתיד למרחבים אחרים של פגישות. בדרך כלל, התוקף של קוד הפגישה יפוג 365 יום אחרי השימוש האחרון בו. מידע נוסף זמין במאמר הסבר על הקודים של פגישות ב-Google Meet.

שם הפגישה

מזהה ייחודי שנוצר על ידי השרת ומשמש לזיהוי מרחב פגישות. הוא תלוי רישיות. לדוגמה, jQCFfuBOdN5z. פרטי הפגישה מוחזרים בשדה name של משאב spaces. מידע נוסף זמין במאמר איך Meet מזהה חדר ישיבות.

מארגן הפגישה

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

מקום הפגישה

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

מזהה URI של הפגישה

כתובת URL שאפשר ללחוץ עליה כדי להתחיל שיחה או להצטרף אליה. לכל שיחה יש כתובת URL ייחודית שמתחילה ב-https://meet.google.com/ וממשיכה בקוד הפגישה. לדוגמה, https://meet.google.com/abc-mnop-xyz.

גורם

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

משתתף

אדם שהצטרף לשיחה או שמשתמש במצב Companion, צופה כמשתתף או שמכשיר בחדר מחובר לשיחה. יש משאב אחד participants לכל אדם. כשמשתתף מצטרף לפגישה, מוקצה לו מזהה ייחודי.

סשן של משתתף

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

הקלטה

קובץ וידאו בפורמט MP4 ומטא-נתונים משויכים שנוצרים כשמבצעים הקלטה של שיחת ועידה. ההקלטות נשמרות ב-Drive של מארגן הפגישה, ואפשר לאחזר אותן כפריטים של הפגישה.

כתובת SIP

כתובת Session Initiation Protocol ‏ (SIP) מפרטת איך ציוד לשיחות ועידה בווידאו של צדדים שלישיים יכול למצוא שיחות ועידה ב-Meet ולהצטרף אליהן. אפליקציית Meet תומכת בסכמת URI של SIP.

הערה חכמה

סיכום תמציתי של הנקודות העיקריות והפעולות לביצוע מכנס שנוצר על ידי Gemini, מיוצא ל-Drive של מארגן הפגישה כקובץ Docs.

תמליל

מסמך טקסט שכולל את השיחה המדוברת מועידה, שיוצא ל-Drive של מארגן הפגישה כקובץ Docs.

תמליל

פלח נפרד של דיבור מתומלל ממשתתף בשיחה. כל רשומה כוללת את זהות המשתתף, חותמת זמן, טקסט מדובר וקוד שפה, והיא זמינה למשך 30 יום אחרי סיום הוועידה.