با Meet Media API شروع کنید

برای استفاده از Google Meet Media API و حوزه‌های OAuth مرتبط با آن، برنامه شما باید از شرایط زیر پیروی کند.

الزامات فنی

محدودیت‌های زیر هنگام کار با Meet Media API اعمال می‌شوند:

برای بهترین نتایج و پشتیبانی:

  • مشتریان باید از کتابخانه libwebrtc استفاده کنند و نسخه نباید بیش از 12 ماه از آخرین نسخه STABLE Chromium عقب باشد. مرورگرهای Chromium از libwebrtc برای پیاده سازی WebRTC JavaScript API استفاده می کنند.

  • مشتریان باید حداقل پهنای باند 4 مگابیت در ثانیه را حفظ کنند.

خط مشی لغو کدک

  • Google این حق را برای خود محفوظ می دارد که در هر زمانی استفاده از کدک را متوقف کند.

  • هنگامی که یک کدک جدید معرفی می شود، توسعه دهندگان 12 ماه قبل از اینکه مشتریان ملزم به پشتیبانی از این کدک شوند، اخطار دریافت خواهند کرد.

احراز هویت و مجوز

سرویس گیرندگان Google Meet Media API از طرف یک کاربر خاص با استفاده از OAuth 2.0 برای احراز هویت و مجوز به یک کنفرانس متصل می شوند.

دسترسی مناسب

با حوزه های 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 خاص مراجعه کنید. اگر داده‌های محدوده محدود را روی سرورها ذخیره می‌کنید (یا ارسال می‌کنید)، پس باید ارزیابی امنیتی را انجام دهید.

اگر برنامه شما نیاز به دسترسی به سایر APIهای Google دارد، می‌توانید آن محدوده‌ها را نیز اضافه کنید. برای اطلاعات بیشتر در مورد دامنه های Google API، به استفاده از OAuth 2.0 برای دسترسی به Google API مراجعه کنید.

برای تعریف اینکه چه اطلاعاتی برای کاربران و بازبینان برنامه نمایش داده می شود، به پیکربندی صفحه رضایت OAuth مراجعه کنید و دامنه ها را انتخاب کنید .

برای اطلاعات بیشتر درباره حوزه‌های خاص OAuth 2.0، به OAuth 2.0 Scopes برای Google API مراجعه کنید.

،

برای استفاده از Google Meet Media API و حوزه‌های OAuth مرتبط با آن، برنامه شما باید از شرایط زیر پیروی کند.

الزامات فنی

محدودیت‌های زیر هنگام کار با Meet Media API اعمال می‌شوند:

برای بهترین نتایج و پشتیبانی:

  • مشتریان باید از کتابخانه libwebrtc استفاده کنند و نسخه نباید بیش از 12 ماه از آخرین نسخه STABLE Chromium عقب باشد. مرورگرهای Chromium از libwebrtc برای پیاده سازی WebRTC JavaScript API استفاده می کنند.

  • مشتریان باید حداقل پهنای باند 4 مگابیت در ثانیه را حفظ کنند.

خط مشی لغو کدک

  • Google این حق را برای خود محفوظ می دارد که در هر زمانی استفاده از کدک را متوقف کند.

  • هنگامی که یک کدک جدید معرفی می شود، توسعه دهندگان 12 ماه قبل از اینکه مشتریان ملزم به پشتیبانی از این کدک شوند، اخطار دریافت خواهند کرد.

احراز هویت و مجوز

سرویس گیرندگان Google Meet Media API از طرف یک کاربر خاص با استفاده از OAuth 2.0 برای احراز هویت و مجوز به یک کنفرانس متصل می شوند.

دسترسی مناسب

با حوزه های 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 خاص مراجعه کنید. اگر داده‌های محدوده محدود را روی سرورها ذخیره می‌کنید (یا ارسال می‌کنید)، پس باید ارزیابی امنیتی را انجام دهید.

اگر برنامه شما نیاز به دسترسی به سایر APIهای Google دارد، می‌توانید آن محدوده‌ها را نیز اضافه کنید. برای اطلاعات بیشتر در مورد دامنه های Google API، به استفاده از OAuth 2.0 برای دسترسی به Google API مراجعه کنید.

برای تعریف اینکه چه اطلاعاتی برای کاربران و بازبینان برنامه نمایش داده می شود، به پیکربندی صفحه رضایت OAuth مراجعه کنید و دامنه ها را انتخاب کنید .

برای اطلاعات بیشتر درباره حوزه‌های خاص OAuth 2.0، به OAuth 2.0 Scopes برای Google API مراجعه کنید.