برای استفاده از رابط برنامهنویسی کاربردی (API) رسانه گوگل میت و حوزههای OAuth 2.0 مرتبط با آن، برنامه شما باید الزامات زیر را رعایت کند.
الزامات فنی
محدودیتهای زیر هنگام کار با Meet Media API اعمال میشوند:
کلاینتها باید از تمام کدکهای زیر پشتیبانی کنند:
-
AV1 -
VP9 -
VP8
-
کلاینتها باید از پیادهسازیهای کدک مطابق با الزامات کدک Meet Media API استفاده کنند، از جمله:
-
libvpx(گوگل) برای رمزگشاییVP8یاVP9 -
dav1d(VideoLAN) برای رمزگشاییAV1
-
کلاینتها باید از افزونههای هدر WebRTC زیر پشتیبانی کنند:
- زمان ارسال مطلق
- کنترل ازدحام در سطح حمل و نقل
- زمان ضبط مطلق
- توصیفگر وابستگی
- نشانگر سطح صدا (
urn:ietf:params:rtp-hdrext:ssrc-audio-level)
مشتریان باید به صورت دورهای مجموعه کاملی از معیارها را ارسال کنند. برای اطلاعات بیشتر، به صفحه معیارهای مشتری مراجعه کنید.
برای بهترین نتایج و پشتیبانی:
کلاینتها باید از کتابخانه
libwebrtcاستفاده کنند و نسخه آن نباید بیش از ۱۲ ماه از آخرین نسخهSTABLEChromium عقب باشد. مرورگرهای Chromium ازlibwebrtcبرای پیادهسازی APIهای جاوا اسکریپت WebRTC استفاده میکنند.کاربران باید حداقل پهنای باند ۴ مگابیت بر ثانیه را حفظ کنند.
فعال کردن Meet REST API
قبل از استفاده از APIهای گوگل، باید آنها را در یک پروژه گوگل کلود فعال کنید. میتوانید یک یا چند API را در یک پروژه گوگل کلود فعال کنید.در کنسول Google Cloud، رابط برنامهنویسی کاربردی REST گوگل میت را فعال کنید.
سیاست منسوخ شدن کدک
گوگل حق دارد در هر زمانی استفاده از یک کدک را متوقف کند.
وقتی یک کدک جدید معرفی میشود، توسعهدهندگان ۱۲ ماه قبل از اینکه مشتریان ملزم به پشتیبانی از این کدک شوند، مطلع میشوند.
احراز هویت و مجوز
کلاینتهای Google Meet Media API از طرف یک کاربر خاص و با استفاده از OAuth 2.0 برای احراز هویت و مجوزدهی به یک کنفرانس متصل میشوند.
دسترسی مناسب
آشنایی با محدودههای 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 محدود شدهاند:
- محدود : این محدودهها دسترسی گستردهای به دادههای کاربر گوگل ارائه میدهند و شما را ملزم به طی کردن یک فرآیند تأیید محدوده محدود میکنند. برای اطلاعات بیشتر در مورد این الزام، به سیاست دادههای کاربر سرویسهای API گوگل و الزامات اضافی برای محدودههای خاص API مراجعه کنید. اگر دادههای محدوده محدود را روی سرورها ذخیره میکنید (یا منتقل میکنید)، باید ارزیابی امنیتی را انجام دهید.
اگر برنامه شما نیاز به دسترسی به هر API گوگل دیگری دارد، میتوانید آن محدودهها را نیز اضافه کنید. برای اطلاعات بیشتر در مورد محدودههای API گوگل، به بخش «استفاده از OAuth 2.0 برای دسترسی به APIهای گوگل» مراجعه کنید.
برای تعریف اطلاعاتی که به کاربران و بررسیکنندگان برنامه نمایش داده میشود، به پیکربندی صفحه رضایت OAuth و انتخاب محدودهها مراجعه کنید.
برای اطلاعات بیشتر در مورد حوزههای خاص OAuth 2.0، به حوزههای OAuth 2.0 برای APIهای گوگل مراجعه کنید.
الزامات کاربر نهایی
برای استفاده از رابط برنامهنویسی کاربردی Meet Media، شرکتکنندگان در Meet باید حداقل الزاماتی را نیز برآورده کنند تا کنفرانس واجد شرایط باشد.
نسخههای اپلیکیشن موبایل
برای کاربران تلفن همراه، آنها باید به این نسخهها بهروزرسانی کنند:
| پلتفرم | برنامه | نسخه |
|---|---|---|
| اندروید | برنامه ملاقات | ۳۰۹ |
| آیاواس | برنامه ملاقات | ۳۰۸ |
| اندروید | برنامه جیمیل | ۲۰۲۵.۰۵.۳۰ |
| آیاواس | برنامه جیمیل | ۶.۰.۲۵۰۵۱۸ |
پلتفرمهای پشتیبانی نشده
ما از کلاینتهای سختافزاری شخص ثالث که Meet را اجرا میکنند پشتیبانی نمیکنیم. برای مثال، اگر کاربران نهایی شما از یک دستگاه اتاق کنفرانس سختافزاری سیسکو که Meet را اجرا میکند استفاده میکنند، نمونه Meet Media API شما نمیتواند به تماس ملحق شود.
محدودیتهای سنی
رابط برنامهنویسی کاربردی Meet Media اجازه جمعآوری رسانه از حسابهایی که برای افراد زیر سن قانونی ثبت شدهاند را ندارد.
اینها معمولاً حسابهایی هستند که در کشور مربوطه زیر سن قانونی (معمولاً زیر ۱۸ سال) هستند یا هنگام ایجاد حساب توسط والدین در برنامه Google Family Link زیر سن قانونی بودهاند.
توجه داشته باشید که برخی مناطق (مانند اتحادیه اروپا) محدودیتهای بیشتری در مورد اینکه چه نوع حسابهایی زیر سن قانونی در نظر گرفته میشوند، دارند.
اگر معتقدید که یکی از حسابهای کاربری شما محدود شده است، میتوانید تأیید سن را ارائه دهید تا بررسی کنید که آیا حساب کاربری آنها از نظر سن تأیید شده است یا خیر. درباره تأیید سن خود بیشتر بدانید .