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

المَعلمات

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

المَعلمات
المَعلمات المطلوبة
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
علامة هذا المرجع.
items[] list
قائمة بالتقييمات التي تطابق معايير الطلب
items[].videoId string
تشير هذه السمة إلى المعرّف الذي تستخدمه منصة YouTube لتعريف الفيديو بشكل فريد.
items[].rating string
تشير هذه السمة إلى التقييم الذي قدّمه المستخدم المفوَّض للفيديو.

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

الأخطاء

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

تجربة

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