Watermarks

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

مواد و روش ها

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

set

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

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 اطلاعات مربوط به زمان نمایش تصویر واترمارک کانال را در حین پخش ویدیو محصور می‌کند.
timing. type	string روش زمان بندی که تعیین می کند چه زمانی تصویر واترمارک در حین پخش ویدیو نمایش داده شود. اگر مقدار offsetFromStart باشد، فیلد offsetMs نشان دهنده یک افست از ابتدای ویدیو است. اگر مقدار offsetFromEnd باشد، فیلد offsetMs یک افست از انتهای ویدیو را نشان می‌دهد.
timing. offsetMs	unsigned long فاصله زمانی تعیین شده بر حسب میلی ثانیه، تعیین می کند که چه زمانی مورد تبلیغ شده در حین پخش ویدیو ظاهر شود. مقدار ویژگی type تعیین می کند که آیا افست از ابتدا یا انتهای ویدیو اندازه گیری می شود.
timing. durationMs	unsigned long مدت زمانی، بر حسب میلی ثانیه، که تصویر واترمارک باید نمایش داده شود.
position	object شی position اطلاعاتی را در مورد موقعیت مکانی درون ویدیو که در آن تصویر واترمارک نمایش داده می شود، محصور می کند.
position. type	string روشی که مورد تبلیغ شده در پخش کننده ویدیو قرار می گیرد. مقادیر معتبر برای این ویژگی عبارتند از: گوشه
position. cornerPosition	string گوشه ای از پخش کننده که در آن مورد تبلیغ شده ظاهر می شود. آیتم همیشه در گوشه سمت راست بالای پخش کننده ظاهر می شود. مقادیر معتبر برای این ویژگی عبارتند از: topRight
imageUrl	string نشانی اینترنتی تصویر واترمارک کانال. YouTube این URL را ایجاد می کند و آن را در پاسخ API به درخواست watermark.set برمی گرداند.
imageBytes	bytes اندازه تصویر واترمارک، بر حسب بایت.
targetChannelId	string شناسه کانال YouTube کانالی که تصویر واترمارک به آن پیوند دارد.