این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Watermarks: unset

تصویر واترمارک کانال را حذف می کند.

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 50 واحدی دارد.

درخواست

POST https://www.googleapis.com/youtube/v3/watermarks/unset

این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).

محدوده
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`
`https://www.googleapis.com/auth/youtube.force-ssl`

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

مولفه های
پارامترهای مورد نیاز
`channelId`	`string` پارامتر `channelId` شناسه کانال YouTube را مشخص می کند که واترمارک برای آن تنظیم نمی شود.
پارامترهای اختیاری
`onBehalfOfContentOwner`	`string` توجه: این پارامتر منحصراً برای شرکای محتوای YouTube در نظر گرفته شده است. پارامتر `onBehalfOfContentOwner` نشان می دهد که اعتبارنامه مجوز درخواست، کاربر YouTube CMS را شناسایی می کند که از طرف مالک محتوا مشخص شده در مقدار پارامتر عمل می کند. این پارامتر برای شرکای محتوای YouTube در نظر گرفته شده است که کانال‌های مختلف YouTube را مالک و مدیریت می‌کنند. این به صاحبان محتوا امکان می‌دهد یک بار احراز هویت کنند و به تمام داده‌های ویدیویی و کانال خود دسترسی داشته باشند، بدون اینکه نیازی به ارائه اعتبارنامه احراز هویت برای هر کانال جداگانه داشته باشند. حساب CMS که کاربر با آن احراز هویت می‌کند باید به مالک محتوای YouTube مشخص شده مرتبط باشد.

هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.

در صورت موفقیت آمیز بودن، این روش کد پاسخ HTTP 204 ( No Content ) را برمی گرداند.

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا	جزئیات خطا	شرح
`forbidden (403)`	`forbidden`	واترمارک برای کانال مشخص شده قابل تنظیم نیست. ممکن است درخواست به درستی مجاز نباشد، یا پارامتر `channelId` روی یک مقدار نامعتبر تنظیم شده باشد.

از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.