REST Resource: networks.sources.content.adBreaks

Risorsa: AdBreak

Metadati dell'interruzione pubblicitaria utilizzati per decidere gli annunci per un'interruzione pubblicitaria in un evento video live.

Rappresentazione JSON 
{
  "name": string,
  "createTime": string,
  "expectedDuration": string,
  "customParams": string,
  "scte35CueOut": string,
  "podTemplateName": string,
  "breakState": enum (BreakState),
  "expectedStartTime": string,
  "expireDuration": string,
  "breakSequence": string,
  "breakParams": {
    object (BreakParams)
  },
  "matchParams": {
    object (MatchParams)
  },
  "servedBreak": {
    object (ServedBreak)
  }
}
Campi
name

string

Solo output. Il nome della risorsa dell'interruzione pubblicitaria. Questo campo avrà il formato "networks//assets//adBreaks/".

network_code è il codice di rete in Google Ad Manager a cui appartengono questi contenuti.

asset_key è la chiave dell'evento live streaming in Google Ad Manager in cui è stata creata l'interruzione pubblicitaria.

adBreakId è la chiave dell'interruzione pubblicitaria. SOLO OUTPUT.
createTime

string (Timestamp format)

Solo output. L'ora di creazione dell'interruzione pubblicitaria.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expectedDuration

string (Duration format)

Obbligatorio. Durata prevista della pausa.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
customParams
(deprecated)

string

Facoltativo. Le coppie chiave-valore da includere nelle richieste di annunci per questa interruzione per il targeting dei criteri personalizzati in Ad Manager. Esempio: "key1=value&key2=value2,value22" Deprecato: imposta cust_params in breakParams.ad_tag_params utilizzando la chiave "cust_params".
scte35CueOut

string

Facoltativo. Dati con codifica Base64 a partire dal cue-out di scte35. Può includere il comando splice_insert() o time_signal(). Esempi: - con time_signal(): “/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==” - con splice_insert(): "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

Facoltativo. Nome del modello pod di Google Ad Manager. Obsoleto: imposta cust_params in breakParams.ad_tag_params utilizzando la chiave "ptpln".
breakState

enum (BreakState)

Solo output. Lo stato attuale dell'interruzione pubblicitaria.
expectedStartTime

string (Timestamp format)

Facoltativo. L'ora di inizio prevista dell'interruzione pubblicitaria.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

Facoltativo. Scade l'interruzione pubblicitaria all'ora expectedStartTime + expireDuration. Se expectedStartTime non è impostato, l'interruzione pubblicitaria scadrà dopo expireDuration dall'inizio del processo decisionale. Valore predefinito: 30 minuti. Minimo: 5 minuti. Massimo: 6 ore.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
breakSequence

string (int64 format)

Solo output. L'ID sequenza mid-roll dell'interruzione pubblicitaria. Più interruzioni pubblicitarie possono avere lo stesso breakSequence se specificato esplicitamente tramite breakParams.ad_tag_params con la chiave mridx. In questo modo, vengono collegati due intervalli pubblicitari GAM.
breakParams

object (BreakParams)

Facoltativo. Parametri dell'interruzione da includere nelle richieste di annuncio per questa interruzione.
matchParams

object (MatchParams)

Facoltativo. Utilizzato per l'inserimento di annunci dinamici (DAI) per determinare la corrispondenza tra un'interruzione pubblicitaria creata tramite l'API e un'interruzione pubblicitaria nel manifest. Quando viene rilevata una nuova interruzione, viene eseguita una funzione di corrispondenza su tutte le interruzioni pubblicitarie di un evento con un valore breakState di SCHEDULED o DECISIONED per verificare se tutti i parametri impostati in matchParams di un'interruzione pubblicitaria corrispondono all'interruzione rilevata. Si verifica una corrispondenza se è soddisfatta una delle seguenti condizioni: 1. La pausa pubblicitaria ha un campo matchParams e tutti i parametri impostati al suo interno corrispondono alla nuova pausa. 2. L'interruzione pubblicitaria è DECISIONED e non ha un campo matchParams.

Per evitare un comportamento "corrispondenza con tutto" accidentale (che si verificherebbe con un matchParams vuoto ma presente), matchParams non può essere vuoto se impostato. Se il campo è presente in una richiesta, deve essere impostato almeno uno dei suoi campi.

Le interruzioni pubblicitarie vengono controllate in questo ordine: 1. con matchParams, ordinate in base a expectedStartTime crescente, createTime crescente, dove le interruzioni pubblicitarie senza expectedStartTime hanno la priorità quando vengono ordinate 2. senza matchParams, ordinate in base a expectedStartTime crescente, createTime crescente, dove le interruzioni pubblicitarie senza expectedStartTime hanno la priorità quando vengono ordinate

Se tutti gli EABN in attesa non corrispondono, DAI tornerà al comportamento di decisione JIT utilizzando l'indice mid-roll successivo disponibile
servedBreak

object (ServedBreak)

Solo output. Riflette le informazioni effettive dell'interruzione pubblicitaria pubblicata. Impostato solo per le interruzioni pubblicitarie con un COMPLETE breakState.

Metodi

create

 API per creare un'interruzione pubblicitaria all'interno del live streaming.

list

 API per elencare le interruzioni pubblicitarie all'interno del live streaming.