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 מכיל מידע על הזמן במהלך הפעלת הסרטון שבו תוצג תמונת סימן המים של הערוץ. האובייקט הזה נדרש כשמפעילים את watermarks.set.
timing.type string
שיטת התזמון שקובעת מתי תמונת סימן המים מוצגת במהלך הפעלת הסרטון. חובה לציין את המאפיין הזה כשמתקשרים אל watermarks.set.

הערכים התקינים הם:
  • ‫offsetFromStart: השדה offsetMs מייצג היסט מתחילת הסרטון.
  • ‫offsetFromEnd: השדה offsetMs מייצג היסט מסוף הסרטון.
timing.offsetMs unsigned long
הזמן שחלף, שצוין באלפיות השנייה, שקובע מתי הפריט המקודם מופיע במהלך הפעלת הסרטון. המאפיין הזה נדרש כשמתקשרים אל watermarks.set. כשהערך בשדה type הוא offsetFromEnd, הערך בשדה offsetMs צריך להיות לפחות 1000 אלפיות שנייה.
timing.durationMs unsigned long
משך הזמן, באלפיות שנייה, שבו תמונת סימן המים תוצג. המאפיין הזה הוא אופציונלי. אם מציינים משך זמן מינימלי, הוא יהיה 1000 אלפיות השנייה. אם הערך של type הוא offsetFromEnd, הערך של durationMs לא יכול להיות גדול מ-offsetMs.
position object
הוצא משימוש: אובייקט position הוצא משימוש ומערכת YouTube מתעלמת ממנו. סימני מים תמיד מוצגים בפינה הימנית העליונה של נגן הווידאו.
imageUrl string
כתובת ה-URL של תמונת סימן המים של הערוץ. מערכת YouTube תיצור את כתובת ה-URL הזו ותחזיר אותה בתגובת ה-API לבקשת watermark.set.
imageBytes bytes
גודל תמונת סימן המים, בבייטים.
targetChannelId string
מזהה ערוץ YouTube של הערוץ שאליו מקושרת תמונת סימן המים.