REST Resource: adBreak.networks.customAssets.adBreaks

Ressource : AdBreak

Métadonnées de coupure publicitaire utilisées pour choisir les annonces à diffuser lors d'une coupure publicitaire dans un événement vidéo en direct.

Représentation 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)
  }
}
Champs
name

string

Uniquement en sortie. Nom de ressource de la coupure publicitaire. Ce champ se présente au format "networks//assets//adBreaks/".

network_code correspond au code réseau dans Google Ad Manager auquel appartient ce contenu.

asset_key correspond à la clé de l'événement de diffusion en direct dans Google Ad Manager sous lequel l'insertion publicitaire a été créée.

adBreakId est la clé de la coupure publicitaire. SORTIE UNIQUEMENT.
createTime

string (Timestamp format)

Uniquement en sortie. Date et heure de création de la coupure publicitaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expectedDuration

string (Duration format)

Obligatoire. Durée de la pause attendue.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
customParams
(deprecated)

string

Facultatif. Paires clé-valeur à inclure dans les demandes d'annonces liées à cette coupure publicitaire pour le ciblage par critères personnalisés dans Ad Manager. Exemple : "key1=value&key2=value2,value22" Obsolète : veuillez définir cust_params dans breakParams.ad_tag_params à l'aide de la clé "cust_params".
scte35CueOut

string

Facultatif. Données encodées en base64 à partir du point de sortie scte35. La commande splice_insert() ou time_signal() peut être incluse. Exemples : - avec time_signal() : "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==" - avec splice_insert() : "/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo="
podTemplateName
(deprecated)

string

Facultatif. Nom du modèle de série d'annonces Google Ad Manager. Obsolète : veuillez définir cust_params dans breakParams.ad_tag_params à l'aide de la clé "ptpln".
breakState

enum (BreakState)

Uniquement en sortie. État actuel de la coupure publicitaire.
expectedStartTime

string (Timestamp format)

Facultatif. Heure de début prévue de la coupure publicitaire.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
expireDuration

string (Duration format)

Facultatif. La coupure publicitaire expire à expectedStartTime + expireDuration. Si expectedStartTime n'est pas défini, le bloc d'annonces expirera expireDuration après le début de la prise de décision. Par défaut : 30 min Minimum : 5 min Maximum : 6 h

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"
breakSequence

string (int64 format)

Uniquement en sortie. ID de la séquence mid-roll de la coupure publicitaire. Plusieurs pauses publicitaires peuvent avoir la même valeur breakSequence si elle est spécifiée explicitement via breakParams.ad_tag_params avec la clé mridx. Cela permet d'associer deux coupures publicitaires GAM.
breakParams

object (BreakParams)

Facultatif. Paramètres de coupure à inclure dans les demandes d'annonces pour cette coupure.
matchParams

object (MatchParams)

Facultatif. Utilisé pour l'insertion dynamique d'annonces assemblées afin de déterminer comment un emplacement publicitaire créé via l'API est associé à un emplacement publicitaire dans le fichier manifeste. Lorsqu'une nouvelle coupure est détectée, une fonction de correspondance est exécutée sur toutes les coupures publicitaires d'un événement dont la valeur breakState est SCHEDULED ou DECISIONED pour vérifier si tous les paramètres définis dans matchParams d'une coupure publicitaire correspondent à la coupure détectée. Une correspondance est établie si l'une des conditions suivantes est remplie : 1. L'insertion publicitaire comporte un champ "matchParams", et tous les paramètres qui y sont définis correspondent à la nouvelle insertion. 2. La coupure publicitaire est DECISIONED et ne comporte pas de champ matchParams.

Pour éviter tout comportement "tout correspond" accidentel (qui se produirait avec un matchParams vide, mais présent), matchParams ne peut pas être vide s'il est défini. Si le champ est présent dans une requête, au moins l'un de ses propres champs doit être défini.

Les coupures publicitaires sont vérifiées dans cet ordre : 1. avec matchParams, classées par ordre croissant de expectedStartTime, puis de createTime, où les coupures publicitaires sans expectedStartTime sont prioritaires lors du tri ; 2. sans matchParams, classées par ordre croissant de expectedStartTime, puis de createTime, où les coupures publicitaires sans expectedStartTime sont prioritaires lors du tri.

Si toutes les EABN en attente ne correspondent pas, la DAI reviendra au comportement de décision JIT en utilisant le prochain index de mid-roll disponible.
servedBreak

object (ServedBreak)

Uniquement en sortie. Cela reflète les informations réelles de la coupure publicitaire diffusée. Défini uniquement pour les coupures publicitaires avec un COMPLETE breakState.

Méthodes

create

 API permettant de créer une coupure publicitaire dans la diffusion en direct.

delete

 API permettant de supprimer une coupure publicitaire dans la diffusion en direct.

get

 API permettant d'obtenir une coupure publicitaire dans la diffusion en direct.

list

 API permettant de lister les coupures publicitaires dans la diffusion en direct.

patch

 API permettant de modifier une coupure publicitaire dans la diffusion en direct.