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