ملاحظة: إنّ واجهة برمجة تطبيقات Content ID في YouTube مُعدّة ليستخدمها شركاء المحتوى في YouTube ولا يمكن لجميع المطورين أو مستخدمي YouTube الوصول إليها. إذا كنت لا ترى YouTube Content ID API باعتبارها إحدى الخدمات المدرجة في وحدة التحكم في واجهة Google API، يُرجى مراجعة مركز مساعدة YouTube للحصول على المزيد من المعلومات حول "برنامج شركاء YouTube".
الخلفية
حساب الخدمة هو حساب Google يمكن استخدامه لتفويض طلبات البيانات من واجهة برمجة التطبيقات بدون أي تفاعل من المستخدم. بخلاف تدفقات OAuth 2.0 الأخرى، لا تتم عملية المصادقة والتفويض باستخدام الوصول باستخدام مسار OAuth 2.0 لحسابات الخدمة في متصفِّح الويب. وبدلاً من ذلك، يعتمد OAuth 2.0 لحسابات الخدمة على التوقيعات المشفّرة لمنح إذن الوصول. وما دام بإمكان الرمز الخاص بك الوصول إلى مفتاح التشفير الأساسي، يمكنه مواصلة إجراء طلبات بيانات من واجهة برمجة التطبيقات بدون القلق بشأن رموز إعادة التحميل والوصول. وهو مثالي للتطبيقات الآلية التي تعمل على الخوادم بدون تدخل بشري.
يمكنك الآن استخدام بروتوكول OAuth 2.0 لحسابات الخدمة من أجل السماح بالطلبات من YouTube Content ID API. يمكنك أيضًا استخدام هذا الإجراء للسماح باستدعاءات YouTube Data API وواجهة برمجة تطبيقات YouTube Analytics للطرق التي تتيح استخدام مَعلمات التفويض. في جميع هذه الحالات، يسمح التطبيق الذي يستخدم هذا المسار بطلب واجهة برمجة التطبيقات بوصفه شريك محتوى في YouTube (باستخدام حساب نظام إدارة محتوى YouTube) وليس كمالك لقناة على YouTube.
إعداد حساب الخدمة
توضّح لقطات الشاشة التالية عملية إنشاء حساب خدمة مرتبط بمشروع واجهة برمجة التطبيقات الخاص بك، وعليك التأكّد من تفعيل واجهات برمجة التطبيقات المناسبة (الإصدار الثالث من YouTube Data API وYouTube Analytics API وYouTube Content ID API وغير ذلك).
- انتقِل إلى https://cloud.google.com/console واختَر مشروع واجهة برمجة التطبيقات الحالي (أو أنشئ مشروعًا جديدًا).
- في الشريط الجانبي على يمين الصفحة، اختَر واجهات برمجة التطبيقات والمصادقة.
- تأكّد من تفعيل YouTube Content ID API لمشروعك.
- في الشريط الجانبي على يمين الصفحة، اختَر بيانات الاعتماد.
- انقر على الزرّ إنشاء معرّف عميل جديد.
- اختَر حساب الخدمة من الخيارات المدرَجة، ثم انقر على إنشاء معرِّف عميل. سيتم تنزيل المفتاح الخاص لحساب الخدمة على جهازك. وهذه هي النسخة الوحيدة من المفتاح وعليك حفظها في مكان آمن يمكن لتطبيقك القراءة منه.
- دوِّن عنوان البريد الإلكتروني لحساب الخدمة. (يظهر عنوان البريد الإلكتروني في صفحة بيانات الاعتماد.) وتحتاج إلى العنوان لمنح حساب الخدمة إمكانية الوصول إلى حسابك على "نظام إدارة محتوى YouTube".
- انتقِل إلى https://www.youtube.com/content_owner_users وانقر على الزر مستخدم جديد.
- أدخِل عنوان البريد الإلكتروني لحساب الخدمة من الخطوة 7 في حقل عنوان البريد الإلكتروني واختَر الدور المناسب للمستخدم. وبعد ذلك انقر على الزر دعوة.
- يقبل حساب الخدمة الدعوة تلقائيًا، وسيتمكّن هذا الحساب لاحقًا من الوصول إلى واجهات برمجة تطبيقات YouTube بالنيابة عن حسابك على "نظام إدارة محتوى YouTube".
- اتّبِع التعليمات المتعلقة بخطوات حساب خدمة OAuth 2.0 في دليل طلبات التفويض من أجل تفويض الطلبات باستخدام حساب الخدمة.
إجراء طلبات بيانات من واجهة برمجة التطبيقات
توفّر مكتبات العملاء لمعظم اللغات توافقًا أصليًا مع OAuth 2.0 لمسار حساب الخدمة. يجب أن تتمكن من اتباع الأمثلة الواردة في مستندات المكتبة لإجراء التفويض الأساسي باستخدام نطاقات واجهة برمجة تطبيقات YouTube المناسبة.
ملاحظة: يجب استخدام مَعلمات التفويض المناسبة للتصرف نيابةً عن قناة معيّنة مرتبطة بحسابك على CMS. لعرض قائمة بالقنوات المرتبطة بحسابك في نظام إدارة المحتوى، انتقل إلى https://cms.youtube.com/edit_user_accounts.