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 کانالی که تصویر واترمارک به آن پیوند دارد.