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 שאליו מקשרת תמונת סימן המים.