REST Resource: advertisers.youtubeAdGroupAds

Ressource: YoutubeGroupAd

Annonce associée à un groupe d'annonces YouTube.

Représentation JSON
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],

  // Union field ad_details can be only one of the following:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  }
  // End of list of possible types for union field ad_details.
}
Champs
name

string

Nom de ressource de l'annonce.

advertiserId

string (int64 format)

Le numéro unique de l'annonceur auquel appartient l'annonce.

adGroupAdId

string (int64 format)

Identifiant unique de l'annonce. Attribué par le système.

adGroupId

string (int64 format)

Identifiant unique du groupe d'annonces auquel l'annonce appartient.

displayName

string

Le nom à afficher de l'annonce.

Doit être encodé au format UTF-8 avec une taille maximale de 255 octets.

entityStatus

enum (EntityStatus)

État de l'entité de l'annonce.

adUrls[]

object (AdUrl)

Liste des URL utilisées par l'annonce.

Champ d'union ad_details. Détails de l'annonce. ad_details ne peut être qu'un des éléments suivants :
displayVideoSourceAd

object (DisplayVideoSourceAd)

Détails d'une annonce provenant d'une campagne display et Création Video 360.

mastheadAd

object (MastheadAd)

Détails d'une annonce diffusée dans le flux d'accueil YouTube

inStreamAd

object (InStreamAd)

Détails d'une annonce InStream désactivable après 5 secondes, utilisée pour renforcer la notoriété de la marque ou atteindre des objectifs marketing.

nonSkippableAd

object (NonSkippableAd)

Détails d'une annonce vidéo InStream courte non désactivable, de 6 à 15 secondes, utilisée pour atteindre les objectifs marketing de couverture

bumperAd

object (BumperAd)

Détails d'une annonce vidéo courte non désactivable, d'une durée inférieure ou égale à six secondes, utilisée pour élargir la couverture.

audioAd

object (AudioAd)

Détails d'une annonce audio utilisée pour atteindre des objectifs marketing.

videoDiscoverAd

object (VideoDiscoveryAd)

Détails d'une annonce faisant la promotion d'une vidéo qui s'affiche aux endroits de découverte.

videoPerformanceAd

object (VideoPerformanceAd)

Informations sur une annonce utilisée dans une campagne vidéo pour l'action afin de générer des actions pour votre entreprise, service ou produit.

DisplayVideoSourceAd

Annonce provenant d'une création DV360.

Représentation JSON
{
  "creativeId": string
}
Champs
creativeId

string (int64 format)

Identifiant de la création source.

MastheadAd

Détails d'une bannière Masthead.

Représentation JSON
{
  "video": {
    object (YoutubeVideoDetails)
  },
  "headline": string,
  "description": string,
  "videoAspectRatio": enum (VideoAspectRatio),
  "autoplayVideoStartMillisecond": string,
  "autoplayVideoDuration": string,
  "callToActionButtonLabel": string,
  "callToActionFinalUrl": string,
  "callToActionTrackingUrl": string,
  "showChannelArt": boolean,
  "companionYoutubeVideos": [
    {
      object (YoutubeVideoDetails)
    }
  ]
}
Champs
video

object (YoutubeVideoDetails)

Vidéo YouTube utilisée par l'annonce.

headline

string

Titre de l'annonce.

description

string

Description de l'annonce.

videoAspectRatio

enum (VideoAspectRatio)

Format de la vidéo YouTube en lecture automatique dans le masthead.

autoplayVideoStartMillisecond

string (int64 format)

Temps au terme duquel la lecture de la vidéo commence, en millisecondes.

autoplayVideoDuration

string (Duration format)

Durée de la lecture automatique de la vidéo.

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

callToActionButtonLabel

string

Texte du bouton d'incitation à l'action

callToActionFinalUrl

string

URL de destination du bouton d'incitation à l'action.

callToActionTrackingUrl

string

URL de suivi du bouton d'incitation à l'action.

showChannelArt

boolean

Permet d'afficher un arrière-plan ou une bannière en haut de la page YouTube.

companionYoutubeVideos[]

object (YoutubeVideoDetails)

Vidéos qui s'affichent à côté de la bannière Masthead sur ordinateur. Ne peut pas être supérieur à deux.

YoutubeVideoDetails

Détails d'une vidéo YouTube.

Représentation JSON
{
  "id": string,
  "unavailableReason": enum (VideoUnavailableReason)
}
Champs
id

string

ID vidéo YouTube pouvant être recherché sur la page Web YouTube.

unavailableReason

enum (VideoUnavailableReason)

Raison pour laquelle les données de la vidéo ne sont pas disponibles.

VideoUnavailableReason

Raisons possibles pour lesquelles une vidéo peut être indisponible.

Enums
VIDEO_UNAVAILABLE_REASON_UNSPECIFIED Inconnu ou non spécifié.
VIDEO_UNAVAILABLE_REASON_PRIVATE Cette vidéo est privée.
VIDEO_UNAVAILABLE_REASON_DELETED La vidéo est supprimée.

VideoAspectRatio

Formats disponibles pour une vidéo YouTube.

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED Non spécifié ou inconnu.
VIDEO_ASPECT_RATIO_WIDESCREEN La vidéo est étirée, et les parties supérieure et inférieure sont recadrées.
VIDEO_ASPECT_RATIO_FIXED_16_9 La vidéo est au format 16:9 fixe.

InStreamAd

Détails d'une annonce InStream.

Représentation JSON
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Champs
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributs d'annonce courants.

customParameters

map (key: string, value: string)

Paramètres personnalisés pour transmettre des valeurs personnalisées au modèle d'URL de suivi.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

CommonInStreamAttribute

Attributs courants pour les annonces InStream, non désactivables et bumper.

Représentation JSON
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Champs
displayUrl

string

Adresse de la page Web qui s'affiche avec l'annonce.

finalUrl

string

URL de la page Web à laquelle les utilisateurs accèdent après avoir cliqué sur l'annonce.

trackingUrl

string

Adresse URL chargée en arrière-plan à des fins de suivi.

actionButtonLabel

string

Texte du bouton d'incitation à l'action

actionHeadline

string

Titre de la bannière d'incitation à l'action.

video

object (YoutubeVideoDetails)

Vidéo YouTube de l'annonce.

companionBanner

object (ImageAsset)

Image qui s'affiche à côté de l'annonce vidéo.

ImageAsset

Métadonnées d'un composant Image.

Représentation JSON
{
  "mimeType": string,
  "fullSize": {
    object (Dimensions)
  },
  "fileSize": string
}
Champs
mimeType

string

Type MIME du composant Image.

fullSize

object (Dimensions)

Métadonnées de cette image dans sa taille d'origine.

fileSize

string (int64 format)

Taille du fichier de l'élément image en octets.

NonSkippableAd

Détails concernant une annonce non désactivable.

Représentation JSON
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  },
  "customParameters": {
    string: string,
    ...
  }
}
Champs
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributs d'annonce courants.

customParameters

map (key: string, value: string)

Paramètres personnalisés pour transmettre des valeurs personnalisées au modèle d'URL de suivi.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

BumperAd

Détails concernant une annonce bumper.

Représentation JSON
{
  "commonInStreamAttribute": {
    object (CommonInStreamAttribute)
  }
}
Champs
commonInStreamAttribute

object (CommonInStreamAttribute)

Attributs d'annonce courants.

AudioAd

Détails d'une annonce audio.

Représentation JSON
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "video": {
    object (YoutubeVideoDetails)
  }
}
Champs
displayUrl

string

Adresse de la page Web qui s'affiche avec l'annonce.

finalUrl

string

URL de la page Web à laquelle les utilisateurs accèdent après avoir cliqué sur l'annonce.

trackingUrl

string

Adresse URL chargée en arrière-plan à des fins de suivi.

video

object (YoutubeVideoDetails)

Vidéo YouTube de l'annonce.

VideoDiscoveryAd

Détails d'une annonce Video Discovery.

Représentation JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "thumbnail": enum (Thumbnail)
}
Champs
headline

string

Titre de l'annonce.

description1

string

Première ligne de texte de l'annonce.

description2

string

Deuxième ligne de texte de l'annonce.

video

object (YoutubeVideoDetails)

Vidéo YouTube dont l'annonce fait la promotion.

thumbnail

enum (Thumbnail)

Vignette utilisée dans l'annonce.

Miniature

Options de miniatures possibles dans les annonces Video Discovery.

Enums
THUMBNAIL_UNSPECIFIED Inconnu ou non spécifié.
THUMBNAIL_DEFAULT La miniature par défaut peut être générée automatiquement ou mise en ligne par un utilisateur.
THUMBNAIL_1 Miniature 1 générée à partir de la vidéo.
THUMBNAIL_2 Miniature 2, générée à partir de la vidéo
THUMBNAIL_3 Miniature 3, générée à partir de la vidéo.

VideoPerformanceAd

Détails concernant une annonce vidéo axée sur les performances.

Représentation JSON
{
  "finalUrl": string,
  "trackingUrl": string,
  "actionButtonLabels": [
    string
  ],
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "domain": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanners": [
    {
      object (ImageAsset)
    }
  ]
}
Champs
finalUrl

string

URL de la page Web à laquelle les utilisateurs accèdent après avoir cliqué sur l'annonce.

trackingUrl

string

Adresse URL chargée en arrière-plan à des fins de suivi.

actionButtonLabels[]

string

Liste des composants texte affichés sur le bouton d'incitation à l'action.

headlines[]

string

Liste des titres affichés sur la bannière d'incitation à l'action.

longHeadlines[]

string

Liste des titres isolés affichés sur la bannière d'incitation à l'action.

descriptions[]

string

Liste des descriptions affichée sur la bannière d'incitation à l'action.

displayUrlBreadcrumb1

string

Premier élément après le domaine dans l'URL à afficher.

displayUrlBreadcrumb2

string

Deuxième élément après le domaine dans l'URL à afficher.

domain

string

Domaine de l'URL à afficher.

videos[]

object (YoutubeVideoDetails)

Liste des assets vidéo YouTube utilisés par cette annonce.

customParameters

map (key: string, value: string)

Paramètres personnalisés pour transmettre des valeurs personnalisées au modèle d'URL de suivi.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

companionBanners[]

object (ImageAsset)

Liste des bannières associées utilisées par cette annonce.

AdUrl

URL supplémentaires associées à l'annonce, y compris les balises.

Représentation JSON
{
  "type": enum (AdUrlType),
  "url": string
}
Champs
type

enum (AdUrlType)

Type d'URL de l'annonce.

url

string

Valeur de la chaîne URL.

AdUrlType

Types d'URL d'annonces possibles.

Enums
AD_URL_TYPE_UNSPECIFIED Inconnu ou non spécifié.
AD_URL_TYPE_BEACON_IMPRESSION Pixel de suivi 1 x 1 envoyé par ping lors de la génération de l'impression d'une création.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Balise d'impression DCM extensible Au moment de la livraison, elle est étendue à plusieurs balises.
AD_URL_TYPE_BEACON_CLICK URL de suivi à pinguer lorsque l'événement de clic est déclenché.
AD_URL_TYPE_BEACON_SKIP URL de suivi à pinguer lorsque l'événement "Ignorer" est déclenché.

Méthodes

get

Permet d'obtenir une annonce d'un groupe d'annonces YouTube.

list

Liste les annonces des groupes d'annonces YouTube.