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

توضّح الأمثلة التالية كيفية استخدام YouTube Data API (الإصدار 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
ملاحظة: يمكنك أيضًا استرداد قائمة بالفيديوهات التي أبدى المستخدم إعجابه بها (ولكن ليست الفيديوهات التي لم تعجبه) باتّباع خطوات استرداد الفيديوهات المفضّلة على القناة. في الخطوة 1 من هذه العملية، بدلاً من استرداد معرّف قائمة التشغيل للفيديوهات المفضلة على القناة، يمكنك استرداد معرّف قائمة التشغيل للفيديوهات التي أعجبتك في القناة. تحتوي السمة contentDetails.relatedPlaylists.likes على القيمة.

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