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
علامة هذا المرجع.
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 لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات من واجهة برمجة التطبيقات والاستجابة لها.