REST Resource: videoAdvertisingOptions

Zasób: VideoAdvertisingOption

Ustawienia reklam dla filmu. Ustawienia te określają, jakie typy reklam mogą być wyświetlane w trakcie filmu oraz w jakich godzinach mogą one być wyświetlane.

Zapis JSON 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Pola
kind

string

Typ zasobu interfejsu API. Wartość dla tego zasobu to youtubePartner#videoAdvertisingOption.
adFormats[]

string

Lista formatów reklam, które mogą być wyświetlane w filmie. Uwaga: od listopada 2023 r. w tej kolumnie można włączać i wyłączać tylko parametr third_party_ads. Więcej informacji znajdziesz w artykule pomocy. Te ustawienia formatów reklam nie są już dostępne i nie powinny być uwzględnione w żądaniu do interfejsu API: instream_standard, display, preroll, postroll.
breakPosition[]

string

Punkt, w którym podczas odtwarzania filmu następuje przerwa.
adBreaks[]

object (AdBreak)

Lista sytuacji, w których YouTube może wyświetlić reklamę In-Stream podczas odtwarzania filmu.
autoGeneratedBreaks

boolean

Umożliwia włączanie automatycznego generowania przerw w trakcie filmu.
id

string

Identyfikator używany w YouTube do jednoznacznego identyfikowania filmu powiązanego z ustawieniami reklam.
tpAdServerVideoId

string

Wartość, która jednoznacznie identyfikuje film na serwerze reklamowym firmy zewnętrznej.
tpTargetingUrl

string

Podstawowy adres URL serwera reklam firmy zewnętrznej, z którego YouTube może pobrać reklamy In-Stream odpowiadające filmowi.
tpUrlParameters

string

Ciąg parametrów, który zostanie dołączony na końcu żądania wysyłanego do serwera reklam firmy zewnętrznej.

AdBreak

Zasób adBreak zawiera informacje o czasie, w którym YouTube może wyświetlać reklamy In-Stream podczas odtwarzania filmu.

Zapis JSON 
{
  "position": string,
  "midrollSeconds": integer
}
Pola
position

string

Punkt, w którym podczas odtwarzania filmu następuje przerwa.
midrollSeconds

integer

Czas przerwy na reklamę określony jako liczba sekund od rozpoczęcia filmu, gdy ma ona miejsce.

Metody

get

 Pobiera ustawienia reklam dla określonego filmu.

getEnabledAds

 Pobiera szczegółowe informacje o typach dozwolonych reklam w przypadku określonego filmu przesłanego przez partnera lub użytkownika.

patch

 Poprawia ustawienia reklam w wybranym filmie.

update

 Aktualizuje ustawienia reklam w wybranym filmie.