REST Resource: videoAdvertisingOptions

Ressource: VideoAdvertisingOption

Die Werbeeinstellungen für ein Video. In den Einstellungen wird festgelegt, welche Arten von Anzeigen während des Videos eingeblendet werden und wann Anzeigen erlaubt sind.

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

string

Der Typ der API-Ressource. Für diese Ressource lautet der Wert youtubePartner#videoAdvertisingOption.
adFormats[]

string

Eine Liste der Anzeigenformate, in denen das Video ausgeliefert werden darf. Hinweis: Ab November 2023 können in dieser Spalte nur „third_party_ads“ aktiviert oder deaktiviert werden. Weitere Informationen findest du in diesem Hilfeartikel. Die folgenden Einstellungen für Anzeigenformate sind nicht mehr verfügbar und sollten nicht in der API-Anfrage enthalten sein: instream_standard, display, preroll, postroll.
breakPosition[]

string

Die Stelle, an der die Unterbrechung während der Videowiedergabe auftritt.
adBreaks[]

object (AdBreak)

Eine Liste der Zeiten, zu denen YouTube während der Wiedergabe des Videos eine In-Stream-Werbung einblenden kann.
autoGeneratedBreaks

boolean

Aktiviert dieses Video für automatisch generierte Mid-Roll-Werbeunterbrechungen.
id

string

Die ID, die YouTube verwendet, um das Video, das mit den Werbeeinstellungen verknüpft ist, eindeutig zu identifizieren.
tpAdServerVideoId

string

Ein Wert, der das Video beim Ad-Server eines Drittanbieters eindeutig identifiziert.
tpTargetingUrl

string

Die Basis-URL des Ad-Servers eines Drittanbieters, von dem YouTube In-Stream-Anzeigen für das Video abrufen kann.
tpUrlParameters

string

Ein Parameterstring, der an den Ad-Server eines Drittanbieters an das Ende der Anfrage angehängt wird.

AdBreak

Eine adBreak-Ressource enthält Informationen zu einem Zeitpunkt, zu dem YouTube während der Videowiedergabe eine In-Stream-Anzeige einblenden kann.

JSON-Darstellung 
{
  "position": string,
  "midrollSeconds": integer
}
Felder
position

string

Die Stelle, an der die Unterbrechung während der Videowiedergabe auftritt.
midrollSeconds

integer

Das ist der Zeitpunkt der Werbeunterbrechung – angegeben in Sekunden nach dem Start des Videos, wenn die Werbeunterbrechung auftritt.

Methoden

get

 Ruft die Werbeeinstellungen für das angegebene Video ab

getEnabledAds

 Ruft Details zu den zulässigen Anzeigentypen für ein bestimmtes von Partnern oder Nutzern hochgeladenes Video ab

patch

 Die Werbeeinstellungen für das angegebene Video werden gepatcht.

update

 Aktualisiert die Werbeeinstellungen für das angegebene Video.