تنفيذ مصادقة OAuth 2.0

يتوافق YouTube Live Streaming API مع OAuth 2.0 بروتوكول للسماح بالوصول إلى بيانات المستخدم الخاصة. تشرح القائمة التالية بعض المفاهيم الأساسية في بروتوكول OAuth 2.0:

  • عندما يحاول المستخدم لأول مرة استخدام ميزات في تطبيقك تتطلب تسجيل الدخول إلى Google Account or YouTube account، يبدأ تطبيقك عملية تفويض OAuth 2.0.

  • يوجّه تطبيقك المستخدم إلى خادم التفويض من Google. يحدّد الرابط المؤدي إلى تلك الصفحة scope الوصول الذي يطلبه تطبيقك لحساب المستخدم. يحدّد scope الموارد التي يمكن لتطبيقك استردادها أو إدراجها أو تعديلها أو حذفها عند العمل كمستخدم مصادَق عليه.

  • إذا وافق المستخدم على منح تطبيقك إذن الوصول إلى هذه الموارد، ستعرض Google رمزًا مميزًا لتطبيقك. اعتمادًا على نوع تطبيقك، إما أن يتحقق من صحة الرمز المميز أو يستبدله بنوع مختلف من الرموز المميزة.

    على سبيل المثال، يستبدل تطبيق الويب من جهة الخادم الرمز المميز الذي تم عرضه برمز دخول ورمز مميز لإعادة التحميل. يسمح رمز الدخول للتطبيق بتفويض الطلبات نيابةً عن المستخدم، ويسمح الرمز المميز لإعادة التحميل للتطبيق باسترداد رمز دخول جديد عند انتهاء صلاحية رمز الدخول الأصلي.

ملاحظة مهمة: لاستخدام تفويض OAuth 2.0، عليك الحصول على بيانات اعتماد التفويض في Google Cloud Console.

لمزيد من التفاصيل، يُرجى الاطّلاع على دليل تفويض OAuth 2.0.

ملاحظة: يجب الموافقة على القناة لاستخدام ميزة البث المباشر على YouTube ، ما يتيح لمالك القناة بث محتوى مباشر على تلك القناة. إذا أرسلت طلبات إلى واجهة برمجة التطبيقات نيابةً عن مستخدم مصادَق عليه لم يتم تفعيل قناته أو لم تكن مؤهّلة لبث محتوى مباشر، ستعرض واجهة برمجة التطبيقات خطأ insufficientPermissions.

مسارات OAuth 2.0

تتوافق Google APIs مع عدة حالات استخدام لبروتوكول OAuth 2.0:

  • يتوافق مسار تطبيقات الويب من جهة الخادم مع تطبيقات الويب التي يمكنها تخزين المعلومات المستمرة بشكل آمن.
  • يتوافق مسار تطبيقات الويب المستندة إلى JavaScript مع تطبيقات JavaScript التي يتم تشغيلها في متصفح.
  • يتوافق مسار تطبيقات الأجهزة الجوّالة وأجهزة الكمبيوترمع التطبيقات المثبَّتة على جهاز، مثل هاتف أو كمبيوتر.
  • يتوافق مسار أجهزة التلفزيون والأجهزة ذات الإمكانات المحدودة لإدخال البيانات مع الأجهزة ذات الإمكانات المحدودة لإدخال البيانات، مثل وحدات تحكّم الألعاب وكاميرات الفيديو.
  • يتوافق مسار OAuth 2.0 لحساب الخدمة مع التفاعلات من خادم إلى خادم التي لا تصل إلى معلومات المستخدم. ومع ذلك، لا تتوافق YouTube Live Streaming API مع هذا المسار. Since there is no way to link a Service Account to a YouTube account, attempts to authorize requests with this flow will generate a NoLinkedYouTubeAccount error.