Watermarks: set

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

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

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

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

درخواست

درخواست HTTP

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

مجوز

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

محدوده
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 مشخص شده مرتبط باشد.

درخواست بدن

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

واکنش

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

خطاها

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

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

آن را امتحان کنید!

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