Watermarks

משאב watermark מזהה תמונה המוצגת במהלך הפעלות של סרטונים בערוץ מסוים. אפשר גם לציין ערוץ יעד שאליו התמונה תקושר, וכן פרטי תזמון שקובעים מתי סימן המים יופיע במהלך הפעלות של סרטונים ומהו משך הזמן שבו הוא מוצג.

שיטות

ה-API תומך בשיטות הבאות עבור משאבי 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 כולל מידע על השעה שבה הסרטון הופעל, כולל תמונת סימן מים של הערוץ.
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
כתובת ה-URL של תמונת סימן המים של הערוץ. YouTube ייצור את כתובת ה-URL הזו ויחזיר אותה בתגובת ה-API לבקשת watermark.set.
imageBytes bytes
הגודל של תמונת סימן המים (בבייטים).
targetChannelId string
מזהה ערוץ YouTube שאליו מקושרת תמונת סימן המים.