ملاحظة: إنّ واجهة برمجة تطبيقات Content ID في YouTube مُعدّة ليستخدمها شركاء المحتوى في YouTube ولا يمكن لجميع المطورين أو مستخدمي YouTube الوصول إليها. إذا كنت لا ترى YouTube Content ID API باعتبارها إحدى الخدمات المدرجة في وحدة التحكم في واجهة Google API، يُرجى مراجعة مركز مساعدة YouTube للحصول على المزيد من المعلومات حول "برنامج شركاء YouTube".
يتوافق YouTube Content ID API مع بروتوكول OAuth 2.0 للسماح بالوصول إلى بيانات المستخدمين الخاصة. توضح القائمة أدناه بعض مفاهيم OAuth 2.0 الأساسية:
-
عندما يحاول المستخدم لأول مرة استخدام وظائف في تطبيقك تتطلب تسجيل دخوله إلى Google Account or YouTube account، يبدأ تطبيقك عملية تفويض OAuth 2.0.
-
يوجّه تطبيقك المستخدم إلى خادم التفويض في Google. يحدّد الرابط المؤدي إلى هذه الصفحة
scope
إذن الوصول الذي يطلبه تطبيقك لحساب المستخدم. تحدِّدscope
الموارد التي يمكن لتطبيقك استردادها أو إدراجها أو تعديلها أو حذفها عند التصرف كمستخدم تمت مصادقته. -
إذا وافق المستخدم على منح تطبيقك الإذن بالوصول إلى هذه الموارد، تعرض Google رمزًا مميّزًا لتطبيقك. وحسب نوع تطبيقك، يتحقّق التطبيق من صحة الرمز المميّز أو يستبدله بنوع مختلف من الرموز المميّزة.
على سبيل المثال، يتبادل تطبيق ويب من جهة الخادم الرمز المميّز المعروض لرمز الدخول ورمز إعادة التحميل. يسمح رمز الدخول للتطبيق بتفويض الطلبات نيابةً عن المستخدم، في حين يتيح رمز إعادة التحميل للتطبيق استرداد رمز دخول جديد عند انتهاء صلاحية رمز الدخول الأصلي.
ملاحظة مهمة: عليك الحصول على بيانات اعتماد التفويض في وحدة تحكّم واجهة برمجة تطبيقات Google لتتمكّن من استخدام تفويض OAuth 2.0.
تدفقات OAuth 2.0
تتوافق واجهات برمجة تطبيقات Google مع العديد من حالات استخدام OAuth 2.0:
- تتوافق خطوات تطبيقات الويب من جهة الخادم مع تطبيقات الويب التي يمكنها تخزين المعلومات الدائمة بأمان.
- يدعم مسار تطبيقات الويب JavaScript تطبيقات JavaScript التي تعمل في المتصفّح.
- يدعم مسار التطبيقات المتوافقة مع الأجهزة الجوّالة وتطبيقات سطح المكتب التطبيقات المثبَّتة على جهاز، مثل الهاتف أو الكمبيوتر.
- يدعم مسار التلفزيونات والأجهزة ذات الإدخال المحدود الأجهزة ذات إمكانات الإدخال المحدودة، مثل وحدات تحكّم الألعاب وكاميرات الفيديو.
- يتيح تدفق حساب الخدمة التفاعلات من خادم إلى خادم والتي لا يمكنها الوصول إلى معلومات المستخدم.