يحذف هذا الطلب قسمًا من القناة.
تأثير الحصة: تبلغ تكلفة الحصة لطلب هذه الطريقة 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 يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون قنوات مختلفة على YouTube ويديرونها. تسمح هذه المَعلمة لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات الفيديو والقناة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب نظام إدارة المحتوى الذي يصادق المستخدم به بمالك المحتوى المحدّد على YouTube. |
|
نص الطلب
لا تُدرِج نص طلب عند طلب هذه الطريقة.
الردّ
إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مورد channelSection في نص الردّ.
الأخطاء
يعرض الجدول التالي رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب هذه الطريقة. يُرجى الاطّلاع على مستندات رسائل الخطأ لمزيد من التفاصيل.
| نوع الخطأ | تفاصيل الخطأ | الوصف |
|---|---|---|
badRequest (400) |
notEditable |
يتعذّر حذف قسم القناة هذا. |
forbidden (403) |
channelSectionForbidden |
لم تتم مصادقة الطلب بشكل صحيح أو أنّه غير متاح لهذه القناة. |
invalidValue (400) |
idInvalid |
تحدّد السمة id معرّفًا غير صالح لقسم القناة. |
invalidValue (400) |
idRequired |
يجب أن تحدّد السمة id قيمة تحدّد قسم القناة الذي يتم حذفه. |
notFound (404) |
channelNotFound |
لم يتم العثور على القناة. |
notFound (404) |
channelSectionNotFound |
تعذّر العثور على قسم القناة الذي تحاول تعديله. |
جرِّبها الآن.
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والردّ عليها.