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

Watermarks: set

یک تصویر واترمارک را در YouTube آپلود می کند و آن را برای یک کانال تنظیم می کند.

این روش از آپلود رسانه پشتیبانی می کند. فایل های آپلود شده باید با این محدودیت ها مطابقت داشته باشند:

حداکثر حجم فایل: 10 مگابایت
انواع MIME رسانه پذیرفته شده: image/jpeg ، image/png ، application/octet-stream

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

درخواست کنید

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد. برای مطالعه بیشتر درباره احراز هویت و مجوز، به اجرای مجوز OAuth 2.0 مراجعه کنید.

دامنه
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube.upload`
`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 مشخص شده مرتبط باشد.

یک منبع watermark در بدنه درخواست ارائه دهید.

در صورت موفقیت آمیز بودن، این روش کد وضعیت HTTP 204 No Content برمی گرداند.

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. برای جزئیات بیشتر، YouTube Data API - Errors را ببینید.

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

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