Watermarks

یک منبع watermark تصویری را مشخص می‌کند که در طول پخش ویدیوهای یک کانال مشخص نمایش داده می‌شود. همچنین می‌توانید کانال هدفی را که تصویر به آن پیوند داده می‌شود، و همچنین جزئیات زمان‌بندی که تعیین می‌کند واترمارک در طول پخش ویدیو چه زمانی ظاهر می‌شود و مدت زمان قابل مشاهده بودن آن را مشخص کنید، مشخص کنید.

روش‌ها

این API از روش‌های زیر برای منابع watermarks پشتیبانی می‌کند:

set
یک تصویر واترمارک را در یوتیوب آپلود می‌کند و آن را برای یک کانال تنظیم می‌کند.
unset
تصویر واترمارک کانال را حذف می‌کند. همین حالا امتحان کنید .

نمایش منابع

ساختار JSON زیر قالب یک منبع watermarks را نشان می‌دهد:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

خواص

جدول زیر ویژگی‌هایی را که در این منبع ظاهر می‌شوند، تعریف می‌کند:

خواص
timing object
شیء timing اطلاعات مربوط به زمان پخش ویدیو را در خود جای می‌دهد، زمانی که تصویر واترمارک کانال نمایش داده می‌شود. این شیء هنگام فراخوانی watermarks.set مورد نیاز است.
timing. type string
روش زمان‌بندی که تعیین می‌کند تصویر واترمارک در طول پخش ویدیو چه زمانی نمایش داده شود. این ویژگی هنگام فراخوانی watermarks.set الزامی است.

مقادیر معتبر عبارتند از:
  • offsetFromStart : فیلد offsetMs نشان‌دهنده‌ی یک فاصله از ابتدای ویدیو است.
  • offsetFromEnd : فیلد offsetMs نشان‌دهنده‌ی فاصله از انتهای ویدیو است.
timing. offsetMs unsigned long
فاصله زمانی، که بر حسب میلی‌ثانیه مشخص شده است، تعیین می‌کند که آیتم تبلیغ‌شده در طول پخش ویدیو چه زمانی ظاهر شود. این ویژگی هنگام فراخوانی watermarks.set الزامی است. وقتی type offsetFromEnd باشد، offsetMs باید حداقل 1000 میلی‌ثانیه باشد.
timing. durationMs unsigned long
مدت زمانی، بر حسب میلی‌ثانیه، که تصویر واترمارک باید نمایش داده شود. این ویژگی اختیاری است. در صورت تعیین، حداقل مدت زمان 1000 میلی‌ثانیه است. وقتی type offsetFromEnd باشد، durationMs نباید از offsetMs بیشتر باشد.
position object
منسوخ شده: شیء position منسوخ شده و توسط یوتیوب نادیده گرفته می‌شود. واترمارک‌ها همیشه در گوشه سمت راست بالای پخش‌کننده ویدیو نمایش داده می‌شوند.
imageUrl string
آدرس اینترنتی (URL) تصویر واترمارک کانال. یوتیوب این آدرس اینترنتی را تولید کرده و آن را در پاسخ API به درخواست watermark.set برمی‌گرداند.
imageBytes bytes
اندازه تصویر واترمارک، بر حسب بایت.
targetChannelId string
شناسه کانال یوتیوب کانالی که تصویر واترمارک به آن لینک شده است.