GuideCategories: list

ملاحظة: هذا إشعار بالإيقاف النهائي.

تم إيقاف كل من المورد guideCategories والطريقة guideCategories.list نهائيًا اعتبارًا من 9 أيلول (سبتمبر) 2020.

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

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

الطلب

طلب HTTP

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

المَعلمات

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

المَعلمات
المَعلمات المطلوبة
part string
تحدّد المعلَمة part سمات الموارد guideCategory التي ستشملها استجابة واجهة برمجة التطبيقات. اضبط قيمة المعلَمة على snippet.
الفلاتر (حدِّد إحدى المَعلمات التالية بالضبط)
id string
تحدّد المعلَمة id قائمة بأرقام تعريف فئات القنوات على YouTube مفصولة بفواصل للموارد التي يتم استردادها. في مورد guideCategory، تحدّد السمة id رقم تعريف فئة القناة على YouTube.
regionCode string
توجّه المَعلمة regionCode واجهة برمجة التطبيقات إلى عرض قائمة بفئات الأدلة المتاحة في البلد المحدّد. قيمة المَعلمة هي رمز بلد بمعيار ISO 3166-1 alpha-2.
المَعلمات الاختيارية
hl string
تحدّد المعلَمة hl اللغة التي سيتم استخدامها للقيم النصية في استجابة واجهة برمجة التطبيقات. القيمة التلقائية هي en-US.

نص الطلب

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

الإجابة

إذا نجحت هذه الطريقة، ستعرض هذه الطريقة نص استجابة بالبنية التالية:

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

أماكن إقامة

يحدد الجدول التالي الخصائص التي تظهر في هذا المورد:

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

الأخطاء

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

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

تجربة

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