REST Resource: videoAdvertisingOptions

Ressource: VideoAdvertisingOption

Paramètres publicitaires d'une vidéo. Les paramètres identifient les types d'annonces pouvant être diffusés pendant la vidéo, ainsi que les moments auxquels les annonces sont autorisées à s'afficher pendant la vidéo.

Représentation JSON 
{
  "kind": string,
  "adFormats": [
    string
  ],
  "breakPosition": [
    string
  ],
  "adBreaks": [
    {
      object (AdBreak)
    }
  ],
  "autoGeneratedBreaks": boolean,
  "id": string,
  "tpAdServerVideoId": string,
  "tpTargetingUrl": string,
  "tpUrlParameters": string
}
Champs
kind

string

Type de ressource d'API. Pour cette ressource, la valeur est youtubePartner#videoAdvertisingOption.
adFormats[]

string

Liste des formats d'annonces que la vidéo est autorisée à diffuser. Remarque: Depuis novembre 2023, seules "third_party_ads" peut être activée/désactivée dans cette colonne. Pour en savoir plus, consultez cet article d'aide. Les commandes de format d'annonce suivantes ne sont plus disponibles et ne doivent pas être incluses dans la requête API: instream_standard, display, preroll et postroll.
breakPosition[]

string

Il s'agit du moment où la coupure publicitaire se produit lors de la lecture de la vidéo.
adBreaks[]

object (AdBreak)

Liste des moments où YouTube peut diffuser une publicité InStream pendant la lecture de la vidéo.
autoGeneratedBreaks

boolean

Activer cette vidéo pour les coupures mid-roll générées automatiquement.
id

string

Identifiant utilisé par YouTube pour identifier de façon unique la vidéo associée aux paramètres d'annonces.
tpAdServerVideoId

string

Valeur qui identifie la vidéo de manière unique sur l'ad server tiers.
tpTargetingUrl

string

URL de base d'un ad server tiers à partir duquel YouTube peut récupérer des annonces InStream pour la vidéo.
tpUrlParameters

string

Chaîne de paramètre à ajouter à la fin de la demande adressée à l'ad server tiers.

AdBreak

Une ressource adBreak contient des informations sur un moment où YouTube peut diffuser une publicité InStream pendant la lecture d'une vidéo.

Représentation JSON 
{
  "position": string,
  "midrollSeconds": integer
}
Champs
position

string

Il s'agit du moment où la coupure publicitaire se produit lors de la lecture de la vidéo.
midrollSeconds

integer

Durée de la coupure publicitaire exprimée en nombre de secondes après le début de la vidéo au moment où la coupure publicitaire se produit.

Méthodes

get

 Récupère les paramètres publicitaires de la vidéo spécifiée.

getEnabledAds

 Récupère les informations sur les types d'annonces autorisées pour une vidéo spécifique mise en ligne par un partenaire ou un utilisateur.

patch

 Applique un correctif aux paramètres publicitaires de la vidéo spécifiée.

update

 Met à jour les paramètres publicitaires de la vidéo spécifiée.