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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Artifact
קובץ שנוצר על ידי Meet בתגובה לועידה, כמו recordings ו- transcripts. הפריטים שנוצרו מהפגישה נשמרים ב-Google Drive של מארגן הפגישה. הם בדרך כלל מוכנים לאחזור זמן קצר אחרי שהשיחה מסתיימת.
אירוע ביומן
אירוע ביומן Google עם כמה משתתפים, שבדרך כלל נוצר על ידי מארגן הפגישה, וכולל את פרטי ההצטרפות לפגישה. יכול להיות ש-Meet הוא הפתרון לכנס של האירוע.
שיחת טלפון
סשן באמצעות Meet, או כדי להודיע לאנשים אחרים שהשיחה מתחילה או נמצאת בעיצומה ולאפשר להם להצטרף אליה מיד.
ועידה
ועידה היא מופע של שיחה בתוך מרחב פגישות. בדרך כלל, משתמשים רואים בתרחיש הזה פגישה אחת.
המאזן בתוך האזור
מזהה ייחודי לכל מופע של שיחת ועידה. הוא נוצר באופן אוטומטי כשהשיחה מתחילה. המשאב 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 אחד לכל סשן. אם המשתתף מצטרף לאותה שיחה כמה פעמים מאותו זוג של משתתף ומכשיר, לכל הצטרפות מוקצה מזהה סשן ייחודי.

כתובת SIP

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