حذف قسم من القناة.
التأثير على الحصة: إنّ استدعاء هذه الطريقة له تكلفة حصة قدرها 50 وحدة.
حالات الاستخدام الشائعة
طلب
طلب HTTP
DELETE https://www.googleapis.com/youtube/v3/channelSections
التفويض
ويتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (اقرأ المزيد عن المصادقة والتفويض).
النطاق |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
المعلَمات
يسرد الجدول التالي المعلمات التي يدعمها طلب البحث هذا. جميع المعلمات المدرجة هي معلمات طلب بحث.
المعلَمات | ||
---|---|---|
المعلّمات المطلوبة | ||
id |
string تحدّد المعلمة id المعرّف الذي يحدّد بشكل فريد قسم القناة الذي يتم حذفه. في المورد channelSection ، تحدّد الخاصية id رقم تعريف القسم. |
|
المعلّمات الاختيارية | ||
onBehalfOfContentOwner |
string لا يمكن استخدام هذه المعلّمة إلا في طلب مفوَّض بشكلٍ سليم. ملاحظة: هذه المعلمة مخصصة حصريًا لشركاء محتوى YouTube. تشير المعلمة onBehalfOfContentOwner إلى أن بيانات اعتماد تفويض الطلب تحدد مستخدم YouTube CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم عليه بمالك محتوى YouTube المحدد. |
نص الطلب
لا تقدِّم نص طلب عند طلب هذه الطريقة.
الإجابة
في حال نجاح هذا الإجراء، ستعرض هذه الطريقة مورد channelchannel في نص الاستجابة.
الأخطاء
يحدد الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء لهذه الطريقة. يرجى الاطلاع على وثائق رسالة الخطأ لمزيد من التفاصيل.
نوع الخطأ | تفاصيل الخطأ | الوصف |
---|---|---|
badRequest (400) |
notEditable |
لا يمكن حذف قسم القناة هذا. |
forbidden (403) |
channelSectionForbidden |
لم تتم مصادقة الطلب بشكل صحيح أو أنه غير معتمد لهذه القناة. |
invalidValue (400) |
idInvalid |
تحدد الخاصية id معرف قسم قناة غير صالح. |
invalidValue (400) |
idRequired |
يجب أن تحدّد السمة id قيمة تحدّد قسم القناة الذي يتم حذفه. |
notFound (404) |
channelNotFound |
لم يتم العثور على القناة. |
notFound (404) |
channelSectionNotFound |
تعذر العثور على قسم القناة الذي تحاول تحديثه. |
جرِّب هذه الميزة الآن.
يمكنك استخدام APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.