Videos: batchGetStats

يستردّ هذا الطلب قائمة بإحصاءات الفيديوهات التي تطابق مَعلمات طلب بيانات من واجهة برمجة التطبيقات.

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

طلب

طلب HTTP

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

التفويض

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

النطاق
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 للمراجع التي يتم استردادها. في مرجع videoStat، تحدّد السمة id رقم تعريف الفيديو.
part	string تحدّد المَعلمة part قائمة قيم مفصولة بفاصلة تتضمّن سمة واحدة أو أكثر من سمات مرجع videoStat التي ستتضمّنها استجابة واجهة برمجة التطبيقات. تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المَعلمة: contentDetails id snippet statistics
المعلمات الاختيارية
onBehalfOfContentOwner	string لا يمكن استخدام هذه المَعلمة إلا في طلب تم تفويضه بشكل صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى على YouTube. تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا في نظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون قنوات مختلفة على YouTube ويديرونها. تسمح هذه المَعلمة لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات الفيديوهات والقنوات، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب "نظام إدارة المحتوى" الذي يصادق المستخدم من خلاله بمالك المحتوى المحدّد على YouTube.

نص الطلب

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

الردّ

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

{
  "kind": "youtube#batchGetStatsResponse",
  "etag": etag,
  "items": [
    {
      "kind": "youtube#videoStats",
      "etag": etag,
      "id": string,
      "snippet": {
        "publishTime": datetime
      },
      "statistics": {
        "viewCount": unsigned long,
        "likeCount": unsigned long,
        "commentCount": unsigned long
      },
      "contentDetails": {
        "duration": string,
        "durationMillis": unsigned long
      }
    }
  ],
  "summary": {
    "requestedVideoCount": unsigned long,
    "succeededVideoCount": unsigned long,
    "failedVideoCount": unsigned long,
    "failedVideoIds": [
      string
    ]
  }
}

الخصائص

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

الخصائص
kind	string يحدّد نوع مرجع واجهة برمجة التطبيقات. ستكون القيمة youtube#batchGetStatsResponse.
etag	etag علامة Etag لهذا المرجع
items[]	list قائمة بإحصاءات الفيديوهات التي تطابق معايير الطلب
items[].id	string رقم التعريف الذي يستخدمه YouTube لتحديد الفيديو بشكل فريد
items[].snippet.publishTime	datetime تاريخ تحميل الفيديو ووقته
items[].statistics.viewCount	unsigned long عدد المرات التي تمت فيها مشاهدة الفيديو
items[].statistics.likeCount	unsigned long عدد المستخدمين الذين أبدوا إعجابهم بالفيديو
items[].statistics.commentCount	unsigned long عدد التعليقات على الفيديو
items[].contentDetails.duration	string مدة الفيديو
items[].contentDetails.durationMillis	unsigned long مدة الفيديو بالملي ثانية
summary	object ملخّص لطلب batchGetStats
summary.requestedVideoCount	unsigned long عدد الفيديوهات المطلوبة
summary.succeededVideoCount	unsigned long عدد الفيديوهات التي تمّت بنجاح
summary.failedVideoCount	unsigned long عدد الفيديوهات التي تعذّر تنفيذها
summary.failedVideoIds[]	list أرقام تعريف الفيديوهات التي تعذّر تنفيذها

الأخطاء

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