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