REST Resource: videoAdvertisingOptions

Risorsa: VideoAdvertisingOption

Le impostazioni pubblicitarie di un video. Le impostazioni identificano i tipi di annunci che possono essere pubblicati durante il video e i momenti in cui è consentita la pubblicazione degli annunci durante il video.

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

string

Il tipo di risorsa API. Per questa risorsa, il valore è youtubePartner#videoAdvertisingOption.

adFormats[]

string

Un elenco dei formati degli annunci che il video è autorizzato a mostrare. Nota: a partire da novembre 2023, solo gli annunci_di_terze_parti possono essere attivati/disattivati in questa colonna. Per ulteriori informazioni, vedi l'articolo del Centro assistenza. I seguenti controlli per i formati degli annunci non sono più disponibili e non devono essere inclusi nella richiesta API: instream_standard, display, preroll, postroll.

breakPosition[]

string

Il punto in cui si verifica l'interruzione durante la riproduzione del video.

adBreaks[]

object (AdBreak)

Un elenco dei momenti in cui YouTube può mostrare una pubblicità in-stream durante la riproduzione del video.

autoGeneratedBreaks

boolean

Consente di attivare questo video per le interruzioni mid-roll generate automaticamente.

id

string

L'ID utilizzato da YouTube per identificare in modo univoco il video associato alle impostazioni pubblicitarie.

tpAdServerVideoId

string

Un valore che identifica in modo univoco il video nell'ad server di terze parti.

tpTargetingUrl

string

L'URL di base per un ad server di terze parti da cui YouTube può recuperare gli annunci in-stream per il video.

tpUrlParameters

string

Una stringa di parametro da aggiungere alla fine della richiesta all'ad server di terze parti.

AdBreak

Una risorsa adBreak contiene informazioni su quando YouTube può mostrare una pubblicità in-stream durante la riproduzione del video.

Rappresentazione JSON
{
  "position": string,
  "midrollSeconds": integer
}
Campi
position

string

Il punto in cui si verifica l'interruzione durante la riproduzione del video.

midrollSeconds

integer

L'ora dell'interruzione pubblicitaria specificata come numero di secondi dopo l'inizio del video quando si verifica l'interruzione.

Metodi

get

Recupera le impostazioni pubblicitarie per il video specificato.

getEnabledAds

Recupera i dettagli sui tipi di annunci consentiti per un video specifico caricato da un partner o da un utente.

patch

Applica patch alle impostazioni pubblicitarie per il video specificato.

update

Consente di aggiornare le impostazioni pubblicitarie per il video specificato.