Meet Media API: מדריך למתחילים ללקוח העזר של TypeScript

בדף הזה מוסבר איך להגדיר ולהריץ דוגמה באמצעות הטמעה של לקוח הפניה ב-TypeScript. אם אתם רוצים לקבל מידע על לקוח C++‎, תוכלו לעיין במדריך להתחלה מהירה של לקוח C++‎.

דרישות מוקדמות

כדי להפעיל את המדריך למתחילים הזה, אתם צריכים שיהיו לכם:

הפעלת Meet API בארכיטקטורת REST

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

מסוף Google Cloud

  1. במסוף Google Cloud, מפעילים את Meet API בארכיטקטורת REST.

    הפעלת ממשקי ה-API

  2. מוודאים שאתם מפעילים את Meet API בארכיטקטורת REST בפרויקט הנכון ב-Cloud, ואז לוחצים על הבא.

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

‫CLI של gcloud

  1. אם צריך, מגדירים את פרויקט Cloud הנוכחי לפרויקט שיצרתם:

    gcloud config set project PROJECT_ID

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

  2. מפעילים את API בארכיטקטורת REST של Meet:

    gcloud services enable meet.googleapis.com

יצירת טוקנים של OAuth

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

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

מריצים את הדוגמה

  1. יצירת לקוח OAuth

  2. בספרייה web/samples, מפתחים את הדוגמה:

    $ yarn install --frozen-lockfile
    $ npx webpack
    
  3. פועלים לפי ההוראות במדריך בנושא אימות לשימוש ב-CLI של gcloud כדי להיכנס ולבחור את פרויקט Google Cloud.

  4. פורסים את השרת ב-Google App Engine.

    $ gcloud app deploy app.yaml
    
  5. עוברים לנקודת הקצה:

    $ gcloud app browse
    
  6. פועלים לפי ההוראות במדריך יצירת פרטי גישה כדי ליצור פרטי כניסה מסוג OAuth 2.0 עם ההיקפים הבאים:

    • https://www.googleapis.com/auth/meetings.conference.media.readonly
    • https://www.googleapis.com/auth/meetings.space.readonly

    מוסיפים את כתובת ה-URL של האפליקציה שפרסתם אל מקורות מורשים של JavaScript וכתובות URI מורשות להפניה אוטומטית.

  7. מעתיקים את מזהה הלקוח ומדביקים אותו בדף האינטרנט שנפרס.

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

  9. יצירת פגישה והצטרפות אליה מעתיקים את קוד הפגישה ומדביקים אותו בשדה 'קוד הפגישה' בדף.

  10. בוחרים את מספר זרמי הווידאו ומפעילים את האודיו.

  11. לוחצים על Create Client ואז על Join Meeting.

  12. בודקים את שידורי הווידאו והאודיו.