REST Resource: videoAdvertisingOptions

מקור מידע: VideoAdvertisingOption

הגדרות הפרסום של הסרטון. ההגדרות מזהות את סוגי המודעות שניתן להציג במהלך הסרטון, וכן את הזמנים שבהם מותר להציג מודעות במהלך הסרטון.

ייצוג JSON 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
שדות
kind

string

הסוג של משאב ה-API. במשאב הזה, הערך הוא youtubePartner#videoAdvertisingOption.
adFormats[]

string

רשימת פורמטים של מודעות שמותר להציג בסרטון. הערה: החל מנובמבר 2023, אפשר להפעיל או להשבית רק מודעות של צד שלישי בעמודה הזו. מידע נוסף זמין במאמר העזרה. אמצעי הבקרה הבאים על פורמטים של מודעות אינם זמינים יותר ואין לכלול אותם בבקשת ה-API: instream_standard, display, preroll, postroll.
breakPosition[]

string

הנקודה שבה ההפסקה מתרחשת במהלך הפעלת הסרטון.
adBreaks[]

object (AdBreak)

רשימת הפעמים שבהן המערכת של YouTube יכולה להציג מודעת וידאו In-stream במהלך הפעלת הסרטון.
autoGeneratedBreaks

boolean

הפעלת הסרטון הזה בהפסקות למודעות באמצע סרטון שנוצרות באופן אוטומטי.
id

string

המזהה שמשמש את YouTube לזיהוי ייחודי של הסרטון המשויך להגדרות הפרסום.
tpAdServerVideoId

string

ערך שמזהה באופן ייחודי את הסרטון לשרת המודעות של צד שלישי.
tpTargetingUrl

string

כתובת ה-URL הבסיסית של שרת מודעות של צד שלישי, שממנו המערכת של YouTube יכולה לאחזר מודעות וידאו In-stream עבור הסרטון.
tpUrlParameters

string

מחרוזת פרמטר שצריך לצרף בסוף הבקשה לשרת המודעות של הצד השלישי.

AdBreak

משאב adBreak מכיל מידע על תקופה שבה YouTube הייתה יכולה להציג מודעת וידאו In-stream במהלך הפעלת סרטון.

ייצוג JSON 
{
  "position": string,
  "midrollSeconds": integer
}
שדות
position

string

הנקודה שבה ההפסקה מתרחשת במהלך הפעלת הסרטון.
midrollSeconds

integer

זמן ההפסקה למודעה מוגדר כמספר השניות אחרי תחילת הסרטון כאשר מתרחשת ההפסקה.

שיטות

get

 אחזור הגדרות הפרסום לסרטון שצוין.

getEnabledAds

 אחזור פרטים על סוגי המודעות המותרות לסרטון שהועלה על ידי שותף או על ידי משתמש.

patch

 תיקון של הגדרות הפרסום בסרטון שצוין.

update

 עדכון הגדרות הפרסום עבור הסרטון שצוין.