Watermarks

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

روش‌ها

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

تنظیم

تصویر ته‌نقش را در YouTube بارگذاری می‌کند و آن را برای کانال تنظیم می‌کند.

تنظیم‌نشده

تصویر ته‌نقش کانال را حذف می‌کند. اکنون امتحان کنید.

نمایش منبع

ساختار 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 منسوخ شده است و YouTube آن را نادیده می‌گیرد. ته‌نقش‌ها همیشه در گوشه بالا سمت راست پخش‌کننده ویدیو نمایش داده می‌شوند.
imageUrl	string نشانی وب تصویر ته‌نقش کانال. YouTube این نشانی وب را تولید می‌کند و آن را در پاسخ میانای برنامه‌سازی کاربردی به درخواست watermark.set برمی‌گرداند.
imageBytes	bytes اندازه تصویر ته‌نقش، به بایت.
targetChannelId	string شناسه کانال YouTube کانالی که تصویر ته‌نقش به آن پیوند داده می‌شود.