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