بخش کانال را حذف می‌کند.
تأثیر بر سهمیه: تماس با این روش هزینه سهمیه ۵۰ واحدی دارد.
موارد استفاده رایج
درخواست
درخواست 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 نشان می‌دهد که اطلاعات کاربری مجوز درخواست، کاربر CMS YouTube را شناسایی می‌کند که از طرف مالک محتوای مشخص‌شده در مقدار پارامتر عمل می‌کند. این پارامتر برای شرکای محتوای YouTube است که مالک و مدیر کانال‌های مختلف YouTube هستند. این ویژگی به مالکان محتوا اجازه می‌دهد یک‌بار اصالت‌سنجی کنند و به همه داده‌های ویدیو و کانال خود دسترسی پیدا کنند، بدون اینکه نیاز باشد برای هر کانال به‌طور جداگانه اعتبارنامه‌های اصالت‌سنجی ارائه دهند. حساب CMS که کاربر با آن اصالت‌سنجی می‌کند باید به مالک محتوای YouTube مشخص‌شده پیوند داده شده باشد. |
|
متن درخواست
هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.
پاسخ
اگر موفقیت‌آمیز باشد، این روش یک منبع channelSection را در بدنه پاسخ برمی‌گرداند.
خطاها
جدول زیر پیام‌های خطایی را که ممکن است «میانای برنامه‌سازی کاربردی» در پاسخ به فراخوانی این روش برگرداند مشخص می‌کند. برای جزئیات بیشتر، لطفاً مستندات پیام خطا را ببینید.
| نوع خطا | جزئیات خطا | شرح |
|---|---|---|
badRequest (400) |
notEditable |
این بخش کانال را نمی‌توان حذف کرد. |
forbidden (403) |
channelSectionForbidden |
درخواست به‌درستی اصالت‌سنجی نشده است یا برای این کانال پشتیبانی نمی‌شود. |
invalidValue (400) |
idInvalid |
ویژگی id شناسه بخش کانال نامعتبری را مشخص می‌کند. |
invalidValue (400) |
idRequired |
ویژگی id باید مقداری را مشخص کند که بخش کانال درحال حذف را شناسایی کند. |
notFound (404) |
channelNotFound |
کانال پیدا نشد. |
notFound (404) |
channelSectionNotFound |
بخش کانالی که می‌خواهید به‌روز کنید پیدا نشد. |
امتحان کنید!
برای فراخوانی این API و دیدن درخواست و پاسخ API، از APIs Explorer استفاده کنید.