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

توضّح الأمثلة التالية كيفية استخدام 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، يمكنك اختيار الطريقة التي تناسب احتياجاتك على أفضل وجه.