التنفيذ: التقييمات

توضح الأمثلة التالية كيفية استخدام واجهة برمجة تطبيقات البيانات في YouTube (الإصدار 3) لتنفيذ وظائف ذات صلة بتقييمات الفيديو.

تقييم فيديو

يمكنك الاتصال بالطريقة videos.rate لإرسال تقييم مستخدم في فيديو معيّن. يجب تفويض هذا الطلب باستخدام OAuth 2.0.

عيِّن المعلمتين التاليتين في طلبك:

  • تحدد المعلمة id معرّف فيديو YouTube الذي يتم تقييمه (أو تتم إزالة تقييمه).
  • تحدّد المعلمة rating التقييم الذي يرغب المستخدم في تفويض الطلب في تسجيله. قيم المعلَمات الصالحة هي like وdislike وnone. تحدّد أول قيمتين تقييمًا، وتزيل القيمة الثالثة أي تقييم كان متوفّرًا للمستخدم من قبل.

يقدم نموذج الطلب أدناه تقييمًا إيجابيًا (يعجبني) لفيديو الكلمة الرئيسية في مؤتمر Google I/O لعام 2014:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.rate?
        id=wtLJPvx7-ys
        &rating=like

استرداد تقييم المستخدم الحالي لمقطع فيديو

تتيح لك طريقة videos.getRating استرداد تقييم المستخدم الذي تمت مصادقته حاليًا لفيديو واحد أو أكثر. في طلبك، اضبط قيمة المعلَمة id على قائمة مفصولة بفواصل بمعرّفات فيديوهات YouTube للموارد التي تسترد بيانات التقييم لها. لاحظ أنه يجب تفويض هذا الطلب باستخدام OAuth 2.0.

يسترد نموذج الطلب أدناه تقييم المستخدم الحالي لفيديو الكلمة الرئيسية في مؤتمر Google I/O لعام 2014. (في حالة تنفيذ المثال السابق في مستكشف واجهات برمجة التطبيقات، فمن المفترض أن تشير استجابة واجهة برمجة التطبيقات إلى أن التقييم هو like.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.getRating?
id=wtLJPvx7-ys

استرداد الفيديوهات التي قيّمها المستخدم الحالي

تتيح لك المعلمة myRating للطريقة videos.list استرداد قائمة بالفيديوهات التي قيّمها المستخدم بتفويض طلب واجهة برمجة التطبيقات. تشير قيمة المعلمة إلى ما إذا كنت تريد استرداد مقاطع الفيديو التي أبديت إعجابك أو عدم إعجابك بها.

يسترد نموذج الطلب أدناه قائمة بمقاطع الفيديو التي قيّم المستخدم الحالي عليها like. يجب تفويض الطلب باستخدام OAuth 2.0.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.list?
part=snippet
&myRating=like
ملاحظة: يمكنك أيضًا استرداد قائمة بالفيديوهات التي أبدى المستخدم إعجابه بها (ولكن ليس الفيديوهات التي لم تعجبه) من خلال اتّباع خطوات استرداد الفيديوهات المفضّلة على القناة. في الخطوة الأولى من هذه العملية، بدلاً من استرداد معرّف قائمة التشغيل لمقاطع الفيديو المفضلة للقناة، يمكنك استرداد معرّف قائمة التشغيل لمقاطع الفيديو التي نالت إعجاب القناة. تحتوي الخاصية contentDetails.relatedPlaylists.likes على القيمة.

وبالتالي، تسمح لك واجهة برمجة التطبيقات باسترداد قائمة من الفيديوهات التي أعجب المستخدم باستخدام الطريقة videos.list أو الطريقة playlistItems.list. بما أنه يتم عرض معلومات مختلفة في مورد video عن مورد playlistItem، يمكنك اختيار الطريقة التي تناسب احتياجاتك على أفضل وجه.