כדי להשתמש ב-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כדי להטמיע את ממשקי WebRTC JavaScript API.ללקוחות צריך להיות רוחב פס מינימלי של 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
היקפי ההרשאות הם ההרשאות שאתם מבקשים מהמשתמשים לאשר כדי שהאפליקציה שלכם תוכל לגשת לתוכן הפגישה. כשמשתמש מתקין את האפליקציה שלכם, הוא מתבקש לאמת את היקפי הגישה האלה. באופן כללי, מומלץ לבחור את ההיקף המצומצם ביותר שאפשר, ולהימנע מבקשת היקפים שהאפליקציה לא צריכה. המשתמשים נוטים יותר להעניק גישה להיקפים מוגבלים שמתוארים בצורה ברורה.
ה-API של Meet Media תומך בהיקף ההרשאות הבא של 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 | 2025.05.30 |
| iOS | אפליקציית Gmail | 6.0.250518 |
פלטפורמות לא נתמכות
אנחנו לא תומכים בלקוחות חומרה של צד שלישי שמריצים את Meet. לדוגמה, אם משתמשי הקצה שלכם משתמשים במכשיר ציוד לחדר ישיבות של Cisco שמריץ את Meet, מופע Meet Media API שלכם לא יכול להצטרף לשיחה.
הגבלות גיל
Meet Media API מוגבל באיסוף מדיה מחשבונות שרשומים על שם קטינים.
בדרך כלל מדובר בחשבונות של משתמשים שלא הגיעו לגיל ההסכמה במדינה שלהם (בדרך כלל מתחת לגיל 18), או שהיו מתחת לגיל ההסכמה כשהחשבון נוצר על ידי הורה באפליקציית Google Family Link.
חשוב לדעת שבחלק מהאזורים (למשל האיחוד האירופי) יש הגבלות נוספות על סוגי החשבונות שמוגדרים כחשבונות של משתמשים מתחת לגיל.
אם אתם חושבים שאחד מהחשבונות של המשתמשים שלכם מוגבל, אתם יכולים לספק אימות גיל כדי לבדוק אם החשבון שלהם אומת. מידע נוסף על אימות הגיל