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 יהיה אפשר להפעיל או להשבית רק את הערך thirdParty בעמודה הזו. מידע נוסף זמין במאמר התמיכה. אמצעי הבקרה הבאים לגבי פורמט המודעות כבר לא זמינים ואין לכלול אותם בבקשת ה-API: instream_standard,‏ display,‏ preroll ו-postroll.
breakPosition[]

string

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

object (AdBreak)

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

boolean

הפעלת האפשרות הזו תאפשר יצירת הפסקות אוטומטיות למודעות באמצע הסרטון. אם הערך של autoGeneratedBreaks מוגדר כ-true בסרטון שבו מוגדרות הפסקות למודעות, המערכות שלנו יזהו מיקומים להצגת מודעות בנוסף למיקומי המודעות שהוגדרו ידנית.
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

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

Methods

get

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

getEnabledAds

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

patch

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

update

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