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. استخدم طريقة videoCategory.list لاسترداد قائمة بالقيم الصالحة.

جرِّب هذه الميزة الآن.

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