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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.