لعرض قائمة تضم channelSection
من الموارد التي تطابق معايير طلب واجهة برمجة التطبيقات.
تأثير الحصّة: إنّ استدعاء لهذه الطريقة لديه تكلفة حصة وحدة واحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
GET https://www.googleapis.com/youtube/v3/channelSections
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
part |
string تحدّد المعلمة part قائمة مفصولة بفواصل لخاصية مورد واحدة أو أكثر من channelSection التي ستتضمّن استجابة واجهة برمجة التطبيقات.إذا حدّدت المعلّمة موقعًا يحتوي على مواقع فرعية، سيتم تضمين الخصائص الفرعية في الاستجابة. على سبيل المثال، في مورد channelSection ، تحتوي الخاصية snippet على خصائص أخرى، مثل عنوان العرض للقسم. في حال ضبط part=snippet ، ستتضمّن استجابة واجهة برمجة التطبيقات أيضًا كل هذه الخصائص المدمَجة.تحتوي القائمة التالية على أسماء part التي يمكنك تضمينها في قيمة المعلّمة:
|
|
الفلاتر (حدد معلمة واحدة من المعلمات التالية) | ||
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.