تنفيذ مصادقة 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 API.

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

مسارات OAuth 2.0

تتوافق واجهات Google APIs العديد من حالات استخدام OAuth 2.0: