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