إيقاف الإصدار 2 من YouTube Data API نهائيًا: الأسئلة الشائعة

يعتمد تطبيقي على التعليقات أو الترجمة والشرح أو بعض الوظائف الأخرى غير المتوفرة في الإصدار 3 من YouTube Data API. ماذا يجب أن أفعل؟

يمكنك مواصلة استخدام الإصدار 2 من واجهة برمجة التطبيقات للتعليقات وتحميل ترجمة وشرح للفيديوهات في الوقت الحالي، وسنضيف هذه الوظيفة إلى الإصدار 3 من واجهة برمجة التطبيقات قريبًا. على الرغم من أنّه ليس لدينا تواريخ محدّدة بعد، سنطرح هذه الوظيفة لكي يتوفّر للمطوّرين أكبر قدر ممكن من الوقت للانتقال إلى الإصدار 3.

بالنسبة إلى بعض الميزات الأخرى، ومع استمرار تطوّر YouTube بشكل عام، لن يكون هناك توافق بنسبة% 100 بين ميزات الإصدار الثاني والإصدار الثالث من واجهات برمجة التطبيقات. يُرجى الاطّلاع على مستندات الإصدار 3 من واجهة برمجة التطبيقات لمعرفة المزيد من التفاصيل حول الوظائف المتوافقة مع الإصدار 3.

في الإصدار 2، يمكنني المصادقة باستخدام عنوان بريد إلكتروني وكلمة مرور من خلال ClientLogin. كيف يمكنني الانتقال إلى OAuth 2.0؟

يُرجى الاطّلاع على دليل الانتقال من ClientLogin إلى OAuth 2.0.

كيف يختلف الحصص في الإصدار 2 عن الإصدار 3؟ ما هي أوجه التشابه؟

يستخدم كلّ من الإصدار 2 والإصدار 3 نظام حصص مستندًا إلى التكلفة، حيث تستهلك بعض العمليات (مثل عمليات التحميل) مقدارًا أكبر من الحصة مقارنةً بغيرها (مثل عمليات البحث).

الفرق الأهم بين نظامَي الإصدار 2 والإصدار 3 هو أنّ الإصدار 3 يوفّر مجموعة حصص عالمية، وهو ما لم يوفّره الإصدار 2. في الإصدار 2، لم تكن الطلبات التي يتم إجراؤها باستخدام مفتاح مطوّر واحد ولكنها واردة من عناوين IP مختلفة أو من مستخدمين مختلفين مصادَق عليهم تتسبّب في حدوث أخطاء في الحصة العالمية لمفتاح المطوّر هذا، بل كان أسوأ ما يمكن أن يحدث هو حدوث خطأ في الحصة المحلية مرتبط بعنوان IP أو قناة YouTube.

في الإصدار 3، هناك مجموعة حصص عالمية (تتألف من 50 مليون وحدة في اليوم)، وتؤدي جميع طلبات البيانات من واجهة برمجة التطبيقات المرتبطة بمشروع معيّن في "وحدة تحكّم المطوّرين" إلى خفض الحصة من هذه المجموعة. لذلك، من الممكن نظريًا أن يستهلك عنوان IP أو قناة واحدة كل الحصة المرتبطة بتسجيل واجهة برمجة التطبيقات، ما قد يؤدي إلى انقطاع الخدمة الذي يؤثر في المستخدمين الآخرين.

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

كان الإصدار الثاني من Data API يتيح الوصول المجهول إلى واجهة برمجة التطبيقات للاستعلامات التي لا تتطلّب سوى الإذن بالقراءة، مثل عمليات البحث عن الفيديوهات. لماذا يجب عليّ التسجيل لإجراء طلبات قراءة فقط في الإصدار 3؟

تم إنشاء الإصدار 3 من واجهة برمجة التطبيقات استنادًا إلى بنية Google API الحديثة، والتي يمكن فيها ربط استخدام العديد من واجهات برمجة التطبيقات المختلفة بتسجيل محدّد في Developer Console. ويوفّر ذلك للمطوّرين طريقة عرض موحّدة لتكنولوجيات Google التي يستخدمونها.

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

يمكن للمطوّرين الحصول على مفاتيح واجهة برمجة التطبيقات البسيطة وبيانات الاعتماد اللازمة لإنشاء رموز OAuth 2.0 المميزة في Google Developers Console. يمكن للمطوّرين أيضًا تجربة واجهة برمجة التطبيقات بدون إنشاء مشروع أولاً باستخدام مستكشف واجهات برمجة التطبيقات.

هل يمكنني مواصلة استخدام مكتبات البرامج نفسها التي استخدمتها مع الإصدار 2 بعد نقل البيانات إلى الإصدار 3؟

تختلف واجهة برمجة التطبيقات الإصدار 3 اختلافًا جوهريًا عن الإصدار 2، وهناك مجموعة جديدة من مكتبات البرامج التي يمكن استخدامها. يمكنك الاطّلاع على جميع هذه المكتبات من خلال https://developers.google.com/youtube/v3/libraries، وتتضمّن جميعها دعمًا أصليًا لعملية التفويض باستخدام OAuth 2.

سبق لي استخدام YouTube Insight API، وهي جزء من الإصدار 2. ما هو البديل؟

ننصح جميع المطوّرين بنقل بياناتهم من YouTube Insight API، التي تم إيقافها نهائيًا بشكل منفصل في أيلول (سبتمبر) 2013، إلى YouTube Analytics API الجديدة.

أعتمد على استخدام GData API (الإصدار 1 أو 2) لخلاصات RSS/Atom الخاصة بفيديوهات YouTube. هل سيتوفّر لي أي بديل بعد إيقافها نهائيًا؟

لا يتوفّر بديل مباشر في الوقت الحالي. ننصحك بمنح مستخدمي تطبيقك إمكانية إدارة اشتراكاتهم على YouTube واستردادها باستخدام طرق خدمة الاشتراكات في الإصدار 3 من YouTube Data API.

بما أنّني ما زلت أستخدم بعض ميزات الإصدار 2 غير المتوفّرة بعد في الإصدار 3، أحتاج إلى الوصول إلى كلا الإصدارَين من واجهة برمجة التطبيقات في التطبيق نفسه. ما هي بعض أفضل الممارسات؟

يمكنك استخدام ميزة التوافق مع OAuth 2.0 في مكتبات الإصدار 3 من أدوات العميل للحصول على رموز مميزة للتفويض تعمل مع عمليات الكتابة في كل من الإصدار 2 والإصدار 3. سيعمل أي رمز مميّز يتضمّن النطاق https://gdata.youtube.com أو https://www.googleapis.com/auth/youtube مع كلتا واجهتَي برمجة التطبيقات.

بالنسبة إلى طلبات البيانات من واجهة برمجة التطبيقات التي لا تتطلّب رموز OAuth 2.0 المميزة، يمكنك الحصول على مفتاح واجهة برمجة التطبيقات الإصدار 3 من https://cloud.google.com/console واستخدامه لكل من الإصدار 2 والإصدار 3.

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