ChannelSections: list

لعرض قائمة تضم channelSection من الموارد التي تطابق معايير طلب واجهة برمجة التطبيقات.

تأثير الحصّة: إنّ استدعاء لهذه الطريقة لديه تكلفة حصة وحدة واحدة.

حالات الاستخدام الشائعة

طلب

طلب HTTP

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

المعلَمات

يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.

المعلَمات
المعلّمات المطلوبة
part string
تحدّد المعلمة part قائمة مفصولة بفواصل لخاصية مورد واحدة أو أكثر من channelSection التي ستتضمّن استجابة واجهة برمجة التطبيقات.

إذا حدّدت المعلّمة موقعًا يحتوي على مواقع فرعية، سيتم تضمين الخصائص الفرعية في الاستجابة. على سبيل المثال، في مورد channelSection، تحتوي الخاصية snippet على خصائص أخرى، مثل عنوان العرض للقسم. في حال ضبط part=snippet، ستتضمّن استجابة واجهة برمجة التطبيقات أيضًا كل هذه الخصائص المدمَجة.

تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلّمة:
  • contentDetails
  • id
  • snippet
الفلاتر (حدد معلمة واحدة من المعلمات التالية)
channelId string
تحدّد المعلمة channelId معرّف قناة على YouTube. إذا حدد طلب قيمة لهذه المعلمة، فلن تعرض واجهة برمجة التطبيقات سوى أقسام القناة المحددة.
id string
تحدّد المعلمة id قائمة بمعرّفات مفصولة بفواصل تحدّد بشكلٍ فريد موارد channelSection التي يتم استردادها. في المورد channelSection، تحدّد الخاصية id رقم تعريف القسم.
mine boolean
لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. يجب ضبط قيمة هذه المعلّمة على true لاسترداد خلاصة أقسام القناة المرتبطة بقناة المستخدم الذي تمت المصادقة عليه على YouTube.
المعلّمات الاختيارية
hl string
تم إيقاف هذه المعلمة نهائيًا. قدّمت المعلّمة hl الدعم لاسترداد البيانات الوصفية المترجمة لقسم من القناة. ولكن تم إيقاف هذه الوظيفة في "استوديو YouTube" وفي تطبيق YouTube.
onBehalfOfContentOwner string
لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء محتوى YouTube.

تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم عليه بمالك محتوى YouTube المحدد.

نص الطلب

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

الإجابة

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

{
  "kind": "youtube#channelSectionListResponse",
  "etag": etag,
  "items": [
    channelSection Resource
  ]
}

أماكن إقامة

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

أماكن إقامة
kind string
تحدد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#channelSectionListResponse.
etag etag
Etag لهذا المورد.
items[] list
قائمة بأقسام القناة التي تتطابق مع معايير الطلب

الأخطاء

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

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) channelSectionForbidden لا يُسمح لمقدّم الطلب بالوصول إلى أقسام القناة المطلوبة.
invalidValue (400) idInvalid يحدد الطلب معرف قسم قناة غير صالح.
invalidValue (400) invalidCriteria تعذّر إكمال الطلب لأن معايير الفلتر غير صالحة.
notFound (404) channelNotFound تعذّر العثور على القناة المرتبطة بالطلب.
notFound (404) channelSectionNotFound تعذر العثور على قسم القناة المرتبط بالطلب.

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

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