VideoCategories: list

تعرض هذه الطريقة قائمة بالفئات التي يمكن ربطها بفيديوهات على YouTube.

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

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

طلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/videoCategories

المعلمات

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

المعلمات
المَعلمات المطلوبة
part string
تحدّد المَعلمة part سمات المورد videoCategory التي سيتضمّنها ردّ واجهة برمجة التطبيقات. اضبط قيمة المَعلمة على snippet.
الفلاتر (يجب تحديد مَعلمة واحدة فقط من المَعلمات التالية)
id string
تحدّد المَعلمة id قائمة معرّفات فئات الفيديوهات المفصولة بفواصل للموارد التي تستردّها.
regionCode ‫string
تطلب المَعلمة regionCode من واجهة برمجة التطبيقات عرض قائمة بفئات الفيديوهات المتوفّرة في البلد المحدّد. قيمة المَعلمة هي رمز بلد ISO 3166-1 alpha-2.
المَعلمات الاختيارية
hl string
تحدّد المَعلمة hl اللغة التي يجب استخدامها للقيم النصية في الردّ من واجهة برمجة التطبيقات. القيمة التلقائية هي en_US.

نص الطلب

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

الردّ

في حال نجاح العملية، يعرض هذا الإجراء نص استجابة بالبنية التالية:

{
  "kind": "youtube#videoCategoryListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    videoCategory resource
  ]
}

الخصائص

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

الخصائص
kind string
تحدّد هذه السمة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#videoCategoryListResponse.
etag etag
تمثّل هذه السمة علامة Etag لهذا المورد.
nextPageToken string
الرمز المميز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج.
prevPageToken string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken من أجل استرداد الصفحة السابقة في مجموعة النتائج.
pageInfo object
يتضمّن العنصر pageInfo معلومات التنقّل بين الصفحات لمجموعة النتائج.
pageInfo.totalResults integer
تمثّل هذه السمة إجمالي عدد النتائج في مجموعة النتائج.
pageInfo.resultsPerPage integer
عدد النتائج المضمّنة في الردّ من واجهة برمجة التطبيقات.
items[] list
قائمة بفئات الفيديوهات التي يمكن ربطها بفيديوهات على YouTube. في هذه الخريطة، يكون معرّف فئة الفيديو هو مفتاح الخريطة، وقيمته هي مورد videoCategory المقابل.

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
notFound (404) videoCategoryNotFound تعذّر العثور على فئة الفيديو التي تم تحديدها من خلال المَعلمة id. استخدِم طريقة videoCategories.list لاسترداد قائمة بالقيم الصالحة.

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

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