כדי להשתמש ב-Google Meet Media API ובהיקפי ההרשאות המשויכים שלו ב-OAuth 2.0, האפליקציה שלכם צריכה לעמוד בדרישות הבאות.
דרישות טכניות
כשעובדים עם Meet Media API, המגבלות הבאות נאכפות:
לקוחות חייבים לתמוך בכל רכיבי ה-codec הבאים:
AV1VP9VP8
לקוחות חייבים להשתמש בהטמעות של קודקים שתואמות ל דרישות הקודק של Meet Media API, כולל:
-
libvpx(Google) כדי לפענח אתVP8אוVP9 -
dav1d(VideoLAN) כדי לפענח אתAV1
-
הלקוחות צריכים לתמוך בתוספי הכותרות הבאים של WebRTC:
- זמן שליחה מוחלט
- Transport-Wide Congestion Control
- זמן הצילום המוחלט
- Dependency Descriptor
- הצגת רמת האודיו
(
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
לקוחות חייבים לשלוח באופן תקופתי חבילה מלאה של מדדים. מידע נוסף זמין בדף מדדי לקוח.
כדי לקבל את התוצאות הטובות ביותר ותמיכה:
אפליקציות הלקוח צריכות להשתמש בספרייה
libwebrtc, והגרסה צריכה להיות עד 12 חודשים אחרי הגרסה האחרונה שלSTABLEChromium. דפדפני Chromium משתמשים ב-libwebrtcכדי להטמיע את ממשקי ה-API של WebRTC JavaScript.ללקוחות צריך להיות רוחב פס מינימלי של 4Mbps.
הפעלת Meet API בארכיטקטורת REST
לפני שאתם משתמשים בממשקי Google API, אתם צריכים להפעיל אותם בפרויקט ב-Google Cloud. בכל פרויקט אפשר להפעיל ממשק API אחד או יותר.במסוף Google Cloud, מפעילים את Google Meet API בארכיטקטורת REST.
מדיניות הוצאה משימוש של קודקים
Google שומרת לעצמה את הזכות להפסיק להשתמש בקודק בכל שלב.
כשמוסיפים קודק חדש, המפתחים מקבלים הודעה 12 חודשים מראש לפני שהלקוחות נדרשים לתמוך בקודק הזה.
אימות והרשאה
לקוחות של Google Meet Media API מתחברים לוועידה בשם משתמש ספציפי, באמצעות OAuth 2.0 לצורך אימות ומתן הרשאות.
גישה מתאימה
היקפי ההרשאות של Meet Media API
היקפי ההרשאות הם ההרשאות שאתם מבקשים מהמשתמשים לאשר כדי שהאפליקציה שלכם תוכל לגשת לתוכן הפגישה. כשמשתמש מתקין את האפליקציה שלכם, הוא מתבקש לאמת את היקפי הגישה האלה. באופן כללי, מומלץ לבחור את ההיקף המצומצם ביותר שאפשר, ולהימנע מבקשת היקפים שהאפליקציה לא צריכה. המשתמשים נוטים יותר להעניק גישה להיקפים מוגבלים שמתוארים בצורה ברורה.
ה-Meet Media API תומך בהיקף OAuth 2.0 הבא:
| קוד היקף | תיאור | שימוש |
|---|---|---|
https://www.googleapis.com/auth/meetings.conference.media.readonly |
תיעוד דיגיטלי של וידאו ואודיו בזמן אמת בשיחות וידאו ב-Google Meet. | הצפייה מוגבלת |
https://www.googleapis.com/auth/meetings.conference.media.audio.readonly |
תיעוד דיגיטלי של אודיו בזמן אמת בשיחות וידאו ב-Google Meet. | הצפייה מוגבלת |
https://www.googleapis.com/auth/meetings.conference.media.video.readonly |
תיעוד דיגיטלי של וידאו בזמן אמת בשיחות וידאו ב-Google Meet. | הצפייה מוגבלת |
בגלל האופי הרגיש של שיחות ועידה, כל היקפי ההרשאות של Meet Media API מוגבלים:
- מוגבל: היקפי הגישה האלה מספקים גישה רחבה לנתוני משתמשים ב-Google, ולכן צריך לעבור תהליך אימות של היקף גישה מוגבל. מידע על הדרישה הזו זמין במאמרים המדיניות של Google בנושא נתוני משתמשים בשירותי API ודרישות נוספות להיקפי הרשאות ספציפיים של API. אם אתם מאחסנים נתונים בהיקף מוגבל בשרתים (או מעבירים אותם), אתם צריכים לעבור בדיקת אבטחה.
בנוסף להיקפי ההרשאות של Meet Media API, צריך גם לבקש את היקף ההרשאות הכללי של קריאת פגישות באמצעות OAuth. היקף ההרשאה הזה נדרש כדי לגשת למטא-נתונים של הפגישה, כמו מידע על המשתתפים והמדיה, וכדי לנהל משא ומתן על חיבור מוצלח.
| קוד היקף | תיאור | שימוש |
|---|---|---|
https://www.googleapis.com/auth/meetings.space.read |
מאפשרת לאפליקציות לקרוא מטא-נתונים על כל מרחב פגישות שלמשתמש יש גישה אליו. | רגיש |
אם האפליקציה שלכם דורשת גישה לממשקי Google API אחרים, אתם יכולים להוסיף גם את היקפי ההרשאות האלה. מידע נוסף על היקפי הרשאות של Google API זמין במאמר שימוש ב-OAuth 2.0 לגישה ל-Google APIs.
כדי להגדיר איזה מידע יוצג למשתמשים ולבודקי האפליקציות, אפשר לעיין במאמר בנושא הגדרת מסך ההסכמה ל-OAuth ובחירת היקפי הרשאות.
מידע נוסף על היקפי הרשאות ספציפיים של OAuth 2.0 מופיע במאמר היקפי הרשאות של OAuth 2.0 ל-Google APIs.
דרישות למשתמשי קצה
כדי להשתמש ב-Meet Media API, המשתתפים ב-Meet צריכים לעמוד בדרישות מינימליות מסוימות כדי שהפגישה תהיה כשירה.
גרסאות של אפליקציות לנייד
משתמשים בנייד צריכים לעדכן לגרסאות הבאות:
| פלטפורמה | אפליקציה | גרסה |
|---|---|---|
| Android | אפליקציית Meet | 309 |
| iOS | אפליקציית Meet | 308 |
| Android | אפליקציית Gmail | 30.5.2025 |
| iOS | אפליקציית Gmail | 6.0.250518 |
פלטפורמות לא נתמכות
אנחנו לא תומכים בלקוחות חומרה של צד שלישי שמריצים את Meet. לדוגמה, אם משתמשי הקצה שלכם משתמשים במכשיר ציוד לחדר ישיבות של Cisco שמריץ את Meet, מופע Meet Media API שלכם לא יכול להצטרף לשיחה.
הגבלות גיל
Meet Media API מוגבל באיסוף מדיה מחשבונות שרשומים על שם קטינים.
בדרך כלל מדובר בחשבונות של משתמשים מתחת לגיל ההסכמה במדינה שלהם (בדרך כלל מתחת לגיל 18), או שהיו מתחת לגיל ההסכמה כשהחשבון נוצר על ידי הורה באפליקציית Google Family Link.
חשוב לדעת שבחלק מהאזורים (למשל האיחוד האירופי) יש הגבלות נוספות על סוגי החשבונות שמוגדרים כחשבונות של משתמשים מתחת לגיל מסוים.
אם אתם חושבים שאחד מהחשבונות של המשתמשים שלכם מוגבל, אתם יכולים לספק אימות גיל כדי לבדוק אם הגיל בחשבון אומת. מידע נוסף על אימות הגיל