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