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