כדי להשתמש ב-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 REST API
לפני שאתם משתמשים בממשקי Google API, אתם צריכים להפעיל אותם בפרויקט ב-Google Cloud. בכל פרויקט אפשר להפעיל ממשק API אחד או יותר.במסוף Google Cloud, מפעילים את Google Meet REST API.
מדיניות הוצאה משימוש של קודקים
Google שומרת לעצמה את הזכות להפסיק להשתמש בקודק בכל שלב.
כשמוסיפים קודק חדש, המפתחים מקבלים הודעה 12 חודשים מראש לפני שהלקוחות נדרשים לתמוך בקודק הזה.
אימות והרשאה
לקוחות של Google Meet Media API מתחברים לוועידה בשם משתמש ספציפי, באמצעות OAuth 2.0 לצורך אימות ומתן הרשאות.
גישה מתאימה
.Meet Media API scopes
היקפי ההרשאות הם ההרשאות שאתם מבקשים מהמשתמשים לאשר כדי שהאפליקציה שלכם תוכל לגשת לתוכן הפגישה. כשמשתמש מתקין את האפליקציה שלכם, הוא מתבקש לאמת את היקפי הגישה האלה. באופן כללי, מומלץ לבחור את ההיקף המצומצם ביותר שאפשר, ולהימנע מבקשת היקפים שהאפליקציה לא צריכה. המשתמשים נוטים יותר להעניק גישה להיקפים מוגבלים שמתוארים בצורה ברורה.
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.
חשוב לדעת שבחלק מהאזורים (למשל האיחוד האירופי) יש הגבלות נוספות על סוגי החשבונות שמוגדרים כחשבונות של משתמשים מתחת לגיל.
אם אתם חושבים שאחד מהחשבונות של המשתמשים שלכם מוגבל, אתם יכולים לספק אימות גיל כדי לבדוק אם הגיל בחשבון אומת. מידע נוסף על אימות הגיל