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 يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون ويديرون العديد من قنوات على YouTube المختلفة. تسمح هذه المَعلمة لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات الفيديو والقناة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة فردية. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم من خلاله بمالك المحتوى المحدّد على YouTube.

نص الطلب

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

الردّ

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

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

الخصائص

يحدّد الجدول التالي السمات التي تظهر في هذا المرجع:

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

الأخطاء

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

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

جرِّبها الآن.

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