Watermarks

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

Methods

ה-API תומך בשיטות הבאות למשאבי watermarks:

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