Videos: getRating

يستردّ هذا الطلب التقييمات التي منحها المستخدم المفوّض لقائمة من الفيديوهات المحدّدة.

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

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

طلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/videos/getRating

التفويض

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

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

المعلمات

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

المعلمات
المعلمات المطلوبة
id string
تحدّد المَعلمة id قائمة قيم مفصولة بفاصلة لمعرّفات فيديوهات على YouTube الخاصة بالمصادر التي تستردّ بيانات التقييم لها. في مصدر video، تحدّد السمة id معرّف الفيديو.
المعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مفوّض بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى على YouTube.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا في نظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون قنوات YouTube مختلفة ويديرونها. تسمح هذه المَعلمة لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم به بمالك المحتوى المحدّد على YouTube.

نص الطلب

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

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة نص استجابة بالبنية التالية:

{
  "kind": "youtube#videoGetRatingResponse",
  "etag": etag,
  "items": [
    {
      "videoId": string,
      "rating": string
    }
  ]
}

الخصائص

يحدّد الجدول التالي الخصائص التي تظهر في هذا المصدر:

الخصائص
kind string
يحدّد نوع مصدر واجهة برمجة التطبيقات. ستكون القيمة youtube#videoGetRatingResponse.
etag etag
علامة Etag لهذا المصدر.
items[] list
قائمة بالتقييمات التي تطابق معايير الطلب.
items[].videoId string
المعرّف الذي يستخدمه YouTube لتحديد الفيديو بشكل فريد.
items[].rating string
التقييم الذي منحه المستخدم المفوّض للفيديو.

القيم الصالحة لهذه السمة هي:
  • dislike
  • like
  • none
  • unspecified

الأخطاء

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

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

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