Videos: rate

إضافة تقييم إعجاب أو عدم إعجاب إلى فيديو أو إزالة تقييم من فيديو

التأثير في الحصة: يتطلّب طلب هذه الطريقة تكلفة حصة تبلغ 50 وحدة.

ملاحظة: لا يؤثر ذلك في العدد الرسمي لعلامات الإعجاب/عدم الإعجاب بالفيديو.

حالات الاستخدام الشائعة

طلب

طلب HTTP

POST https://www.googleapis.com/youtube/v3/videos/rate

التفويض

يتطلّب هذا الطلب الحصول على إذن باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

المعلمات

يسرد الجدول التالي المَعلمات التي يتيحها طلب البحث هذا. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المَعلمات المطلوبة
id string
تحدّد المَعلمة id معرّف فيديو YouTube الذي يتم تقييمه أو إزالة تقييمه.
rating string
تحدّد التقييم الذي سيتم تسجيله.

القيم المقبولة هي:
  • dislike: يسجّل هذا الحدث أنّ المستخدم الذي تمت مصادقته لم يعجبه الفيديو.
  • ‫like: لتسجيل إعجاب المستخدم الذي تمّت مصادقته بالفيديو
  • ‫none: لإزالة أي تقييم سبق أن وضعه المستخدم الذي تمت مصادقته للفيديو.

نص الطلب

لا تقدِّم نص الطلب عند استدعاء هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، ستعرض رمز استجابة HTTP ‏204 (No Content).

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
badRequest (400) emailNotVerified يجب أن يثبت المستخدم ملكية عنوان بريده الإلكتروني قبل التقييم.
badRequest (400) invalidRating تضمّن الطلب قيمة غير متوقّعة للمَعلمة rating.
badRequest (400) videoPurchaseRequired يمكن فقط للمستخدمين الذين استأجروا الفيديوهات تقييمها.
forbidden (403) forbidden لا يمكن تقييم الفيديو الذي تحاول تقييمه. قد لا يكون الطلب مصرّحًا به بشكل صحيح.
forbidden (403) videoRatingDisabled أوقف مالك الفيديو الذي تحاول تقييمه ميزة التقييمات لهذا الفيديو.
notFound (404) videoNotFound يتعذّر العثور على الفيديو الذي تحاول تقييمه. تحقَّق من قيمة مَعلمة id في الطلب للتأكّد من صحتها.

جرِّبها الآن.

استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة.