REST Resource: advertisers.adGroupAds

Ressource : AdGroupAd

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

Représentation JSON
{
  "name": string,
  "advertiserId": string,
  "adGroupAdId": string,
  "adGroupId": string,
  "displayName": string,
  "adPolicy": {
    object (AdPolicy)
  },
  "entityStatus": enum (EntityStatus),
  "adUrls": [
    {
      object (AdUrl)
    }
  ],
  "dcmTrackingInfo": {
    object (DcmTrackingInfo)
  },
  "containsSyntheticMedia": boolean,
  "parentCreativeId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "displayVideoSourceAd": {
    object (DisplayVideoSourceAd)
  },
  "mastheadAd": {
    object (MastheadAd)
  },
  "inStreamAd": {
    object (InStreamAd)
  },
  "nonSkippableAd": {
    object (NonSkippableAd)
  },
  "bumperAd": {
    object (BumperAd)
  },
  "audioAd": {
    object (AudioAd)
  },
  "videoDiscoverAd": {
    object (VideoDiscoveryAd)
  },
  "videoPerformanceAd": {
    object (VideoPerformanceAd)
  },
  "demandGenVideoAd": {
    object (DemandGenVideoAd)
  },
  "demandGenImageAd": {
    object (DemandGenImageAd)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAd)
  },
  "demandGenProductAd": {
    object (DemandGenProductAd)
  }
  // End of mutually exclusive fields.
}
Champs
name

string

Uniquement en sortie. Nom de ressource de l'annonce.

advertiserId

string (int64 format)

Uniquement en sortie. Identifiant unique de l'annonceur auquel l'annonce appartient.

adGroupAdId

string (int64 format)

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

adGroupId

string (int64 format)

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

displayName

string

Obligatoire. Nom à afficher de l'annonce.

Doit être encodé en UTF-8 et ne pas dépasser 255 octets.

adPolicy

object (AdPolicy)

Uniquement en sortie. État d'approbation de l'annonce par rapport aux règles.

entityStatus

enum (EntityStatus)

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

adUrls[]

object (AdUrl)

Uniquement en sortie. Liste des URL utilisées par l'annonce.

dcmTrackingInfo

object (DcmTrackingInfo)

Facultatif. les informations sur l'annonce de suivi DCM ;

Pour supprimer les informations sur l'annonce de suivi DCM, veuillez laisser ce champ vide.

containsSyntheticMedia

boolean

Facultatif. Indique si l'annonce contient des médias modifiés ou synthétiques.

Ne doit être défini que pour les annonces créées par des annonceurs électoraux validés. Valable uniquement pour les annonces YouTube.

parentCreativeId

string (int64 format)

Uniquement en sortie. ID de la création Display & Video 360 utilisée pour générer cette annonce.

Ce champ ne sera renseigné que pour les annonces générées à partir de créations attribuées au groupe d'annonces parent.

Détails de l'annonce. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
displayVideoSourceAd

object (DisplayVideoSourceAd)

Uniquement en sortie. Détails d'une annonce provenant d'une création Display & Video 360.

mastheadAd

object (MastheadAd)

Uniquement en sortie. Détails d'une annonce diffusée dans le flux d'accueil YouTube.

inStreamAd

object (InStreamAd)

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

nonSkippableAd

object (NonSkippableAd)

Uniquement en sortie. Détails d'une annonce vidéo InStream courte non désactivable, d'une durée de 6 à 15 secondes, utilisée pour atteindre des objectifs marketing de couverture.

bumperAd

object (BumperAd)

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

audioAd

object (AudioAd)

Uniquement en sortie. Détails d'une annonce audio utilisée pour atteindre des objectifs marketing de couverture.

videoDiscoverAd

object (VideoDiscoveryAd)

Uniquement en sortie. Détails d'une annonce promouvant une vidéo qui s'affiche dans les emplacements de découverte.

videoPerformanceAd

object (VideoPerformanceAd)

Uniquement en sortie. Détails d'une annonce utilisée dans une campagne vidéo pour l'action afin de générer des actions en lien avec l'entreprise, le service ou le produit.

demandGenVideoAd

object (DemandGenVideoAd)

Facultatif. Détails d'une annonce vidéo Demand Gen.

demandGenImageAd

object (DemandGenImageAd)

Facultatif. Détails d'une annonce illustrée Demand Gen.

demandGenProductAd

object (DemandGenProductAd)

Facultatif. Informations détaillées sur une annonce produit Demand Gen.

Fin des champs mutuellement exclusifs.

DisplayVideoSourceAd

Annonce provenant d'une création DV360.

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

string (int64 format)

ID de la création source.

MastheadAd

Informations sur 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)

Durée en millisecondes après laquelle la lecture de la vidéo commence.

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

Indique si un arrière-plan ou une bannière s'affiche en haut d'une page YouTube.

companionYoutubeVideos[]

object (YoutubeVideoDetails)

Vidéos s'affichant à côté de la bannière Masthead sur ordinateur. Ne peut pas comporter plus de deux chiffres après la virgule.

YoutubeVideoDetails

Informations sur une vidéo YouTube.

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

string

Uniquement en sortie. ID vidéo YouTube qui peut être recherché sur la page Web YouTube.

unavailableReason

enum (VideoUnavailableReason)

Uniquement en sortie. Raison pour laquelle les données vidéo ne sont pas disponibles.

videoAssetId

string (int64 format)

Obligatoire. ID du composant vidéo YouTube. Il s'agit de l'adAssetId d'une ressource AdAsset.

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 possibles 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 utilise un format fixe de 16:9.

InStreamAd

Informations sur une annonce InStream.

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

object (CommonInStreamAttribute)

Obligatoire. Attributs d'annonce courants.

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'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,
  "userSpecifiedTrackingUrl": string,
  "actionButtonLabel": string,
  "actionHeadline": string,
  "video": {
    object (YoutubeVideoDetails)
  },
  "companionBanner": {
    object (ImageAsset)
  }
}
Champs
displayUrl

string

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

finalUrl

string

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

trackingUrl

string

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

Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans userSpecifiedTrackingUrl dans la v5.

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

actionButtonLabel

string

Facultatif. Texte du bouton d'incitation à l'action.

Doit être défini si actionHeadline est défini.

actionHeadline

string

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

video

object (YoutubeVideoDetails)

Obligatoire. Immuable. Vidéo YouTube de l'annonce.

companionBanner

object (ImageAsset)

Facultatif. 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,
  "assetId": string
}
Champs
mimeType

string

Uniquement en sortie. Type MIME du composant Image.

fullSize

object (Dimensions)

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

fileSize

string (int64 format)

Uniquement en sortie. Taille du fichier du composant Image, en octets.

assetId

string (int64 format)

Obligatoire. Identifiant unique de l'asset.

NonSkippableAd

Informations sur une annonce non désactivable.

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

object (CommonInStreamAttribute)

Obligatoire. Attributs d'annonce courants.

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

BumperAd

Informations sur une annonce bumper.

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

object (CommonInStreamAttribute)

Obligatoire. Attributs d'annonce courants.

AudioAd

Informations sur une annonce audio.

Représentation JSON
{
  "displayUrl": string,
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": 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 internautes accèdent après avoir cliqué sur l'annonce.

trackingUrl

string

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

Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans userSpecifiedTrackingUrl dans la v5.

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

video

object (YoutubeVideoDetails)

Vidéo YouTube de l'annonce.

VideoDiscoveryAd

Informations sur une annonce vidéo 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)

Miniature utilisée dans l'annonce.

Miniature

Options de miniatures possibles dans les annonces vidéo Discovery.

Enums
THUMBNAIL_UNSPECIFIED Inconnu ou non spécifié.
THUMBNAIL_DEFAULT Miniature par défaut, qui peut être générée automatiquement ou importée par l'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

Informations sur une annonce vidéo axée sur les performances.

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

string

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

trackingUrl

string

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

Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans userSpecifiedTrackingUrl dans la v5.

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

actionButtonLabels[]

string

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

Doit être défini si headlines est défini.

headlines[]

string

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

longHeadlines[]

string

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

Doit être défini, sauf si le champ lineItemType de l'élément de campagne parent est défini sur LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, auquel cas ce champ ne peut pas être défini.

descriptions[]

string

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

Doit être défini, sauf si le champ lineItemType de l'élément de campagne parent est défini sur LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE, auquel cas ce champ ne peut pas être défini.

displayUrlBreadcrumb1

string

Facultatif. Première partie après le domaine dans l'URL à afficher.

displayUrlBreadcrumb2

string

Facultatif. Deuxième partie après le domaine dans l'URL à afficher.

Ne peut être défini que si displayUrlBreadcrumb1 est également défini.

domain

string

Uniquement en sortie. Domaine de l'URL à afficher.

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

companionBanners[]

object (ImageAsset)

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

businessName

string

Facultatif. Nom de l'établissement affiché dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

DemandGenVideoAd

Détails d'une annonce vidéo Demand Gen.

Représentation JSON
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": enum (CallToAction),
  "headlines": [
    string
  ],
  "longHeadlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string,
  "videos": [
    {
      object (YoutubeVideoDetails)
    }
  ],
  "customParameters": {
    string: string,
    ...
  },
  "companionBanner": {
    object (ImageAsset)
  },
  "logo": {
    object (ImageAsset)
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string
}
Champs
finalUrl

string

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

trackingUrl

string

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

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

callToAction

enum (CallToAction)

Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce.

Les valeurs acceptées sont les suivantes :

  • AUTOMATED
  • LEARN_MORE
  • GET_QUOTE
  • APPLY_NOW
  • SIGN_UP
  • CONTACT_US
  • SUBSCRIBE
  • DOWNLOAD
  • BOOK_NOW
  • SHOP_NOW
  • BUY_NOW
  • DONATE_NOW
  • ORDER_NOW
  • PLAY_NOW
  • SEE_MORE
  • START_NOW
  • VISIT_SITE
  • WATCH_NOW
headlines[]

string

Obligatoire. Liste des titres affichés dans l'annonce.

longHeadlines[]

string

Obligatoire. Liste des titres longs affichés dans l'annonce.

descriptions[]

string

Obligatoire. Liste des descriptions affichées dans l'annonce.

displayUrlBreadcrumb1

string

Facultatif. Première partie après le domaine dans l'URL à afficher.

displayUrlBreadcrumb2

string

Facultatif. Deuxième partie après le domaine dans l'URL à afficher.

videos[]

object (YoutubeVideoDetails)

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

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

companionBanner

object (ImageAsset)

Facultatif. Bannière associée utilisée par cette annonce.

finalMobileUrl

string

Facultatif. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce sur un appareil mobile.

finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL de page de destination.

businessName

string

Facultatif. Nom de l'établissement affiché dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

CallToAction

Valeurs d'incitation à l'action possibles pour les annonces vidéo/produit Demand Gen.

Enums
CALL_TO_ACTION_UNSPECIFIED Non spécifié ou inconnu.
AUTOMATED Automatisation.
LEARN_MORE En savoir plus
GET_QUOTE Obtenir un devis.
APPLY_NOW Inscrivez-vous dès maintenant.
SIGN_UP S'inscrire.
CONTACT_US Contactez-nous.
SUBSCRIBE S'abonner
DOWNLOAD Télécharger.
BOOK_NOW Réservez maintenant.
SHOP_NOW Achetez-les dès maintenant.
BUY_NOW Acheter.
DONATE_NOW Faire un don
ORDER_NOW Commandez maintenant.
PLAY_NOW Jouez maintenant.
SEE_MORE Voir plus.
START_NOW Démarrez maintenant.
VISIT_SITE Accéder au site.
WATCH_NOW Regardez-les maintenant.

DemandGenImageAd

Détails d'une annonce illustrée Demand Gen.

Représentation JSON
{
  "finalUrl": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "callToAction": string,
  "headlines": [
    string
  ],
  "descriptions": [
    string
  ],
  "customParameters": {
    string: string,
    ...
  },
  "finalMobileUrl": string,
  "finalUrlSuffix": string,
  "businessName": string,
  "marketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (ImageAsset)
    }
  ],
  "logoImages": [
    {
      object (ImageAsset)
    }
  ]
}
Champs
finalUrl

string

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

trackingUrl

string

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

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

callToAction

string

Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce.

headlines[]

string

Obligatoire. Liste des titres affichés dans l'annonce.

descriptions[]

string

Obligatoire. Liste des descriptions affichées dans l'annonce.

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

finalMobileUrl

string

Facultatif. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce sur un appareil mobile.

finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL de page de destination.

businessName

string

Facultatif. Nom de l'établissement affiché dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

marketingImages[]

object (ImageAsset)

Liste des images marketing affichées dans l'annonce.

squareMarketingImages[]

object (ImageAsset)

Liste des images marketing carrées affichées dans l'annonce.

portraitMarketingImages[]

object (ImageAsset)

Liste des images marketing en mode portrait affichées dans l'annonce.

logoImages[]

object (ImageAsset)

Liste des images de logo affichées dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

DemandGenCarouselAd

Informations sur une annonce carrousel Demand Gen.

Représentation JSON
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "cards": [
    {
      object (CarouselCard)
    }
  ],
  "finalUrlSuffix": string,
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  }
}
Champs
finalUrl

string

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

headline

string

Obligatoire. Titre de l'annonce.

description

string

Obligatoire. Description de l'annonce.

cards[]

object (CarouselCard)

Obligatoire. Liste des fiches affichées dans l'annonce.

finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL de page de destination.

trackingUrl

string

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

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

businessName

string

Facultatif. Nom de l'établissement affiché dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

CarouselCard

Informations sur une fiche de carrousel Demand Gen.

Représentation JSON
{
  "finalUrl": string,
  "finalMobileUrl": string,
  "headline": string,
  "callToAction": string,
  "marketingImage": {
    object (ImageAsset)
  },
  "squareMarketingImage": {
    object (ImageAsset)
  },
  "portraitMarketingImage": {
    object (ImageAsset)
  }
}
Champs
finalUrl

string

Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur la fiche.

finalMobileUrl

string

Facultatif. URL de la page Web à laquelle les utilisateurs accèdent après avoir cliqué sur la fiche sur un appareil mobile.

headline

string

Obligatoire. Titre de la fiche.

callToAction

string

Obligatoire. Texte du bouton d'incitation à l'action affiché sur la fiche.

Doit comporter 10 caractères maximum.

marketingImage

object (ImageAsset)

Facultatif. Image marketing affichée sur la fiche.

squareMarketingImage

object (ImageAsset)

Facultatif. Image marketing carrée affichée sur la fiche.

portraitMarketingImage

object (ImageAsset)

Facultatif. Image marketing en mode portrait affichée sur la fiche.

DemandGenProductAd

Informations sur une annonce produit Demand Gen.

Représentation JSON
{
  "finalUrl": string,
  "headline": string,
  "description": string,
  "finalUrlSuffix": string,
  "callToAction": enum (CallToAction),
  "trackingUrl": string,
  "userSpecifiedTrackingUrl": string,
  "businessName": string,
  "customParameters": {
    string: string,
    ...
  },
  "logo": {
    object (ImageAsset)
  },
  "displayUrlBreadcrumb1": string,
  "displayUrlBreadcrumb2": string
}
Champs
finalUrl

string

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

headline

string

Obligatoire. Titre de l'annonce.

description

string

Obligatoire. Description de l'annonce.

finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL de page de destination.

callToAction

enum (CallToAction)

Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce.

Les valeurs acceptées sont les suivantes :

  • AUTOMATED
  • APPLY_NOW
  • BOOK_NOW
  • CONTACT_US
  • DOWNLOAD
  • GET_QUOTE
  • LEARN_MORE
  • SHOP_NOW
  • SIGN_UP
  • SUBSCRIBE
trackingUrl

string

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

userSpecifiedTrackingUrl

string

Facultatif. URL de suivi spécifiée manuellement par l'utilisateur.

businessName

string

Facultatif. Nom de l'établissement affiché dans l'annonce.

Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée.

customParameters

map (key: string, value: string)

Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi.

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

displayUrlBreadcrumb1

string

Facultatif. Première partie après le domaine dans l'URL à afficher.

displayUrlBreadcrumb2

string

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

AdPolicy

Règle relative aux annonces associée à une annonce de groupe d'annonces.

Représentation JSON
{
  "adPolicyApprovalStatus": enum (AdPolicyApprovalStatus),
  "adPolicyReviewStatus": enum (AdPolicyReviewStatus),
  "adPolicyTopicEntry": [
    {
      object (AdPolicyTopicEntry)
    }
  ]
}
Champs
adPolicyApprovalStatus

enum (AdPolicyApprovalStatus)

État d'approbation d'une annonce, indiquant la décision d'approbation.

adPolicyReviewStatus

enum (AdPolicyReviewStatus)

État de la vérification du respect des règles d'une annonce, indiquant l'étape actuelle du processus d'examen.

adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Entrées pour chaque thème de règle identifié comme étant lié à l'annonce. Chaque entrée inclut le thème, le niveau de restriction et des conseils pour résoudre les problèmes liés aux règles.

AdPolicyApprovalStatus

États possibles d'une approbation des règles relatives aux annonces.

Enums
AD_POLICY_APPROVAL_STATUS_UNKNOWN Inconnu ou non spécifié.
DISAPPROVED Ne sera pas diffusé.
APPROVED_LIMITED Sera diffusée avec des restrictions.
APPROVED Sera diffusée sans restriction.
AREA_OF_INTEREST_ONLY La diffusion n'aura pas lieu dans les pays ciblés, mais pourra avoir lieu pour les utilisateurs qui recherchent des informations sur les pays ciblés.

AdPolicyReviewStatus

États possibles de la vérification du respect des règles relatives aux annonces.

Enums
AD_POLICY_REVIEW_STATUS_UNKNOWN Inconnu ou non spécifié.
REVIEW_IN_PROGRESS En cours d'examen.
REVIEWED Examen principal terminé. D'autres examens peuvent être en cours.
UNDER_APPEAL Renvoyé pour approbation ou une décision liée au règlement a fait l'objet d'un appel.
ELIGIBLE_MAY_SERVE Jugée éligible et peut être diffusée. Un examen plus approfondi pourrait toujours avoir lieu.

AdPolicyTopicEntry

Entrée décrivant comment une annonce a été identifiée comme étant liée à une règle relative aux annonces.

Représentation JSON
{
  "policyTopic": string,
  "policyLabel": string,
  "policyTopicDescription": string,
  "policyTopicType": enum (AdPolicyTopicEntryType),
  "policyDecisionType": enum (AdPolicyDecisionType),
  "policyEnforcementMeans": enum (AdPolicyEnforcementMeans),
  "policyTopicEvidences": [
    {
      object (AdPolicyTopicEvidence)
    }
  ],
  "policyTopicConstraints": [
    {
      object (AdPolicyTopicConstraint)
    }
  ],
  "helpCenterLink": string,
  "appealInfo": {
    object (AdPolicyTopicAppealInfo)
  }
}
Champs
policyTopic

string

Thématique de la règle.

Par exemple, "TRADEMARKS", "ALCOHOL", etc.

policyLabel

string

Texte du libellé localisé pour la règle.

Par exemple, "Marques dans le texte", "Contient de l'alcool", etc.

policyTopicDescription

string

Brève description du thème de la règle.

policyTopicType

enum (AdPolicyTopicEntryType)

Comment la diffusion des annonces sera-t-elle affectée en raison de la relation avec le thème des règles relatives aux annonces ?

policyDecisionType

enum (AdPolicyDecisionType)

La source de la décision liée aux règles.

policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Moyens d'application des règles utilisés lors de la vérification du respect des règles.

policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Preuve utilisée dans la décision liée aux règles.

policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Contraintes de diffusion pertinentes pour la décision liée aux règles.

appealInfo

object (AdPolicyTopicAppealInfo)

Informations sur la procédure à suivre pour faire appel de la décision liée aux règles.

AdPolicyTopicEntryType

Impacts possibles d'un thème des règles relatives aux annonces sur la diffusion.

Enums
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN Inconnu ou non spécifié.
PROHIBITED La ressource ne sera pas diffusée.
FULLY_LIMITED La ressource ne sera pas diffusée dans tous les pays ciblés.
LIMITED La ressource ne peut pas être diffusée dans certains pays.
DESCRIPTIVE La ressource peut être diffusée.
BROADENING La ressource peut être diffusée, et peut l'être au-delà de la couverture normale.
AREA_OF_INTEREST_ONLY La ressource est limitée pour tous les pays ciblés, mais elle peut être diffusée auprès des utilisateurs qui recherchent des informations sur les pays ciblés.

AdPolicyDecisionType

Sources possibles d'une décision liée aux règles.

Enums
AD_POLICY_DECISION_TYPE_UNKNOWN Inconnu ou non spécifié.
PURSUANT_TO_NOTICE La décision est basée sur une mention légale, une ordonnance du tribunal, une réclamation du propriétaire d'une marque, etc.
GOOGLE_INVESTIGATION La décision est issue d'une enquête menée par Google.

AdPolicyEnforcementMeans

Moyens possibles d'application des règles utilisés lors de la vérification du respect des règles.

Enums
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN Inconnu ou non spécifié.
AUTOMATED La procédure d'application était entièrement automatisée.
HUMAN_REVIEW Un humain a été partiellement ou totalement impliqué dans le processus d'application de la décision.

AdPolicyTopicEvidence

Informations sur les preuves utilisées dans la décision liée aux règles.

Représentation JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of mutually exclusive fields.
}
Champs
Preuve de la décision liée aux règles. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
textList

object (TextList)

Liste des preuves trouvées dans le texte de l'annonce.

websiteList

object (WebsiteList)

Liste des sites Web associés à l'annonce.

httpCode

integer

Code HTTP renvoyé lors de l'exploration de l'URL finale.

languageCode

string

Langue dans laquelle l'annonce a été détectée.

Ce champ utilise des tags de langue IETF, tels que "en-US".

destinationTextList

object (DestinationTextList)

Texte de la destination de l'annonce qui entraîne un non-respect des règles.

destinationMismatch

object (DestinationMismatch)

Différence entre les URL de destination des annonces.

destinationNotWorking

object (DestinationNotWorking)

Informations sur les erreurs HTTP ou DNS liées à la destination de l'annonce.

trademark

object (Trademark)

Termes de marque ayant entraîné un cas de non-respect des règles.

legalRemoval

object (LegalRemoval)

Application d'une réglementation légale ayant entraîné un non-respect des règles.

counterfeit

object (Counterfeit)

Mesure d'application pour contrefaçon ayant entraîné un non-respect des règles.

regionalRequirements

object (RegionalRequirements)

Mesure d'application proactive de l'équipe Confiance et sécurité ayant entraîné un non-respect des règles.

Fin des champs mutuellement exclusifs.

TextList

Liste des fragments de texte qui ont enfreint la règle.

Représentation JSON
{
  "texts": [
    string
  ]
}
Champs
texts[]

string

Fragments de texte de la ressource qui ont déclenché le résultat de la règle.

WebsiteList

Liste des sites Web qui ont enfreint la règle.

Représentation JSON
{
  "websites": [
    string
  ]
}
Champs
websites[]

string

Sites Web à l'origine du problème de non-respect des règles.

DestinationTextList

Liste des textes de destination qui ont enfreint la règle.

Représentation JSON
{
  "destinationTexts": [
    string
  ]
}
Champs
destinationTexts[]

string

Texte de destination à l'origine du problème de non-respect des règles.

DestinationMismatch

Détails sur une différence entre les types d'URL de destination.

Représentation JSON
{
  "uriTypes": [
    enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Champs
uriTypes[]

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

Ensemble d'URL qui ne correspondent pas. La liste peut inclure un ou plusieurs types d'URI.

Exemple 1 : [DISPLAY_URL, FINAL_URL] signifie que l'URL à afficher de l'annonce ne correspond pas à l'URL finale de l'annonce.

Exemple 2 : [FINAL_URL] signifie que l'URL finale de l'annonce ne correspond pas à l'URL explorée, ce qui est également considéré comme une différence de destination.

AdPolicyTopicEvidenceDestinationMismatchUrlType

Types d'URL possibles.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_MISMATCH_URL_TYPE_UNKNOWN Non spécifié ou inconnu.
DISPLAY_URL URL à afficher.
FINAL_URL URL finale.
FINAL_MOBILE_URL URL finale pour mobile.
TRACKING_URL URL de suivi.
MOBILE_TRACKING_URL URL de suivi pour mobile.

DestinationNotWorking

Informations sur les erreurs HTTP ou DNS liées à la destination de l'annonce.

Représentation JSON
{
  "expandedUri": string,
  "device": enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType),
  "lastCheckedTime": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dnsErrorType": enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of mutually exclusive fields.
}
Champs
expandedUri

string

L'URL complète qui n'a pas fonctionné.

device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

L'appareil sur lequel la visite de l'URL a entraîné l'erreur.

lastCheckedTime

string (Timestamp format)

Dernière fois que l'erreur a été détectée lors de l'accès à l'URL.

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".

Erreur HTTP ou DNS. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Type d'erreur DNS.

httpErrorCode

string (int64 format)

Code d'erreur HTTP.

Fin des champs mutuellement exclusifs.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Types d'erreurs DNS possibles.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN Non spécifié ou inconnu.
HOSTNAME_NOT_FOUND Nom d'hôte introuvable dans le DNS lors de la récupération de la page de destination.
GOOGLE_CRAWLER_DNS_ISSUE Google n'a pas pu explorer la page de destination lors de la communication avec le DNS.

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Appareils potentiels ayant rencontré une erreur lors de l'accès à l'URL.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Non spécifié ou inconnu.
DESKTOP Ordinateur de bureau.
ANDROID Appareil Android.
IOS appareil iOS.

Marque

Termes de marque ayant entraîné un cas de non-respect des règles.

Représentation JSON
{
  "owner": string,
  "term": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Champs
owner

string

Le propriétaire de la marque.

term

string

Le nom de la marque.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Pays dans lesquels le non-respect des règles est pertinent.

AdPolicyCriterionRestriction

Représente une restriction locale applicable.

Représentation JSON
{
  "countryCriterionId": string,
  "countryLabel": string
}
Champs
countryCriterionId

string (int64 format)

ID du critère de pays.

countryLabel

string

Nom localisé du pays. Peut être vide.

LegalRemoval

Application de réglementations juridiques, qu'elles soient issues du DMCA ou de réglementations locales.

Représentation JSON
{
  "complaintType": enum (AdPolicyTopicEvidenceLegalRemovalComplaintType),
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ],
  "restrictedUris": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of mutually exclusive fields.
}
Champs
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Type de réclamation à l'origine de la suppression pour motif légal.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Pays soumis à des restrictions en raison de la suppression pour motif légal.

restrictedUris[]

string

URL dont l'accès est limité en raison d'une suppression pour motif légal.

Détails sur le type de suppression pour motif légal. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
dmca

object (Dmca)

Détails sur la suppression pour motif légal en vertu du DMCA.

Fin des champs mutuellement exclusifs.

DMCA

Détails de la réclamation DMCA.

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

string

Entité qui a déposé la réclamation d'ordre juridique.

LocalLegal

Informations sur les réglementations locales.

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

string

Type de loi pour la mention légale.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Types de réclamations possibles pour une suppression pour motif légal.

Enums
COPYRIGHT

Droits d'auteur.

S'applique uniquement au DMCA.

COURT_ORDER

Ordonnance du tribunal.

S'applique uniquement aux mentions légales locales.

Contrefaçon

Informations sur la mesure d'application concernant la contrefaçon qui a entraîné un cas de non-respect des règles.

Représentation JSON
{
  "owners": [
    string
  ]
}
Champs
owners[]

string

Les propriétaires du contenu ou du produit qui ont déposé une réclamation

RegionalRequirements

Application proactive des règles par l'équipe Trust & Safety (T&S) pour répondre aux exigences régionales. Il s'agit d'une enquête menée par Google, et non d'un avis réglementaire, car il s'agit d'une application proactive des conditions d'utilisation.

Représentation JSON
{
  "regionalRequirementsEntries": [
    {
      object (RegionalRequirementsEntry)
    }
  ]
}
Champs
regionalRequirementsEntries[]

object (RegionalRequirementsEntry)

Liste des exigences régionales.

RegionalRequirementsEntry

Détails du non-respect des lois régionales au niveau des règles.

Représentation JSON
{
  "legalPolicy": string,
  "countryRestrictions": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Champs
legalPolicy

string

Le règlement juridique qui n'est pas respecté.

countryRestrictions[]

object (AdPolicyCriterionRestriction)

Pays soumis à des restrictions en raison du règlement juridique.

AdPolicyTopicConstraint

Informations sur les contraintes de diffusion des annonces.

Représentation JSON
{
  "requestCertificateFormLink": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of mutually exclusive fields.
}
Champs
Contrainte de diffusion. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
countryConstraint

object (AdPolicyCountryConstraintList)

Pays dans lesquels l'annonce ne peut pas être diffusée.

resellerConstraint

object (AdPolicyResellerConstraint)

Contrainte de revendeur.

certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Pays dans lesquels un certificat est requis pour la diffusion.

certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

Pays dans lesquels le domaine de la ressource n'est pas couvert par les certificats qui lui sont associés.

globalCertificateMissing

object (AdPolicyGlobalCertificateMissingConstraint)

Un certificat est requis pour diffuser des annonces dans n'importe quel pays.

globalCertificateDomainMismatch

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

Un certificat est requis pour diffuser l'annonce dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce.

Fin des champs mutuellement exclusifs.

AdPolicyCountryConstraintList

Liste des pays dans lesquels l'annonce ne peut pas être diffusée en raison de contraintes liées aux règles.

Représentation JSON
{
  "countries": [
    {
      object (AdPolicyCriterionRestriction)
    }
  ]
}
Champs
countries[]

object (AdPolicyCriterionRestriction)

Pays dans lesquels l'annonce ne peut pas être diffusée.

AdPolicyResellerConstraint

Ce type ne comporte aucun champ.

Le thème de la règle a été limité, car le site Web a été refusé pour des raisons de revente.

AdPolicyGlobalCertificateMissingConstraint

Ce type ne comporte aucun champ.

Un certificat est requis pour diffuser des annonces dans n'importe quel pays.

AdPolicyGlobalCertificateDomainMismatchConstraint

Ce type ne comporte aucun champ.

Un certificat est requis pour diffuser l'annonce dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce.

AdPolicyTopicAppealInfo

Informations sur la procédure à suivre pour faire appel d'une décision liée aux règles.

Représentation JSON
{
  "appealType": enum (AdPolicyAppealType),
  "appealFormLink": string
}
Champs
appealType

enum (AdPolicyAppealType)

La possibilité ou non de faire appel via un appel en libre-service ou un formulaire d'appel.

AdPolicyAppealType

Types d'appels possibles.

Enums
AD_POLICY_APPEAL_TYPE_UNKNOWN Inconnu ou non spécifié.
SELF_SERVICE_APPEAL Vous pouvez faire appel de la décision en libre-service.
APPEAL_FORM Vous pouvez faire appel de la décision à l'aide d'un formulaire d'appel.

AdUrl

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

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

enum (AdUrlType)

Type de l'URL de l'annonce.

url

string

Valeur de la chaîne d'URL.

AdUrlType

Types d'URL d'annonce possibles.

Enums
AD_URL_TYPE_UNSPECIFIED Inconnu ou non spécifié.
AD_URL_TYPE_BEACON_IMPRESSION Pixel de suivi 1x1 à pinger lorsqu'une impression d'une création est diffusée.
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION Balise d'impression DCM extensible. Au moment de la diffusion, il est développé en plusieurs balises.
AD_URL_TYPE_BEACON_CLICK URL de suivi à pinger lorsque l'événement de clic est déclenché.
AD_URL_TYPE_BEACON_SKIP URL de suivi à pinguer lorsque l'événement d'abandon est déclenché.

DcmTrackingInfo

Détails sur le suivi DCM.

Représentation JSON
{
  "placementId": string,
  "trackingAdId": string,
  "creativeId": string
}
Champs
placementId

string (int64 format)

Obligatoire. ID d'emplacement DCM.

trackingAdId

string (int64 format)

Obligatoire. ID de l'annonce de suivi DCM.

creativeId

string (int64 format)

Obligatoire. ID de la création DCM.

Méthodes

create

Crée une annonce de groupe d'annonces.

delete

Supprime une annonce de groupe d'annonces.

get

Récupère une annonce de groupe d'annonces.

list

Répertorie les annonces du groupe d'annonces.

patch

Met à jour une annonce de groupe d'annonces.