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
علامة هذا المرجع.
items[] list
قائمة بأقسام القنوات التي تتطابق مع معايير الطلب

الأخطاء

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

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

تجربة

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