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