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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מחרוזת ייחודית בת 10 תווים שאפשר להקליד בשביל מרחב לפגישה, ומשמשת במזהה ה-URI של הפגישה במרחב לפגישה. הוא לא תלוי אותיות רישיות. לדוגמה: 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.

משתתף

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

סשן של משתתף

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