REST Resource: advertisers.adGroupAds

Ressource : AdGroupAd

Une seule annonce 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)
  },

  // 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 appartient l'annonce.
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 concernant les 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. Informations sur l'annonce de suivi DCM. Valable uniquement pour les annonces de génération de la demande.

Pour supprimer les informations de suivi des annonces DCM, veuillez laisser ce champ vide.
Informations sur l'annonce. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
displayVideoSourceAd

object (DisplayVideoSourceAd)

Uniquement en sortie. Informations sur 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 comprise entre 6 et 15 secondes, utilisée pour les 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 maximale de 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. Informations sur une annonce promouvant une vidéo qui s'affiche dans les lieux 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 d'inciter les utilisateurs à agir concernant l'entreprise, le service ou le produit.
demandGenVideoAd

object (DemandGenVideoAd)

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

object (DemandGenImageAd)

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

object (DemandGenProductAd)

Détails d'une annonce produit Demand Gen.
Fin des champs qui s'excluent mutuellement.

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 pendant laquelle la vidéo sera lue automatiquement.

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 doit s'afficher 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 être supérieur à deux.

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)

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 du adAssetId d'une ressource AdAsset.

VideoUnavailableReason

Raisons possibles pour lesquelles une vidéo peut ne pas être disponible.

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 le haut et le bas sont recadrés.
VIDEO_ASPECT_RATIO_FIXED_16_9 La vidéo utilise un format 16:9 fixe.

InStreamAd

Informations sur 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 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 communs aux 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,
  "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 à sa taille d'origine.
fileSize

string (int64 format)

Uniquement en sortie. Taille du fichier de l'asset image en octets.
assetId

string (int64 format)

Obligatoire. Identifiant unique de l'élément.

NonSkippableAd

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

Attributs d'annonce courants.

AudioAd

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

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 promue par l'annonce.
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 La miniature par défaut 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,
  "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 longs affichés sur la bannière d'incitation à l'action.
descriptions[]

string

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

string

Première partie de l'URL à afficher après le domaine.
displayUrlBreadcrumb2

string

Il s'agit du deuxième élément après le domaine dans l'URL à afficher.
domain

string

Domaine de l'URL à afficher.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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)

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

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 utilisateurs accèdent après avoir cliqué sur l'annonce.
trackingUrl

string

Uniquement en sortie. Adresse 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 de l'URL à afficher après le domaine.
displayUrlBreadcrumb2

string

Facultatif. Il s'agit du deuxième élément 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 utilisateurs accèdent après avoir cliqué sur l'annonce sur un appareil mobile.
finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL des pages 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 elle n'est pas définie, la valeur par défaut sera appliquée.

CallToAction

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

Enums
CALL_TO_ACTION_UNSPECIFIED Non spécifié ou inconnu.
AUTOMATED Automatisation.
LEARN_MORE En savoir plus
GET_QUOTE Obtenez 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 dès 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édez au site.
WATCH_NOW Regardez-les maintenant.

DemandGenImageAd

Informations détaillées sur 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 utilisateurs accèdent après avoir cliqué sur l'annonce.
trackingUrl

string

Uniquement en sortie. Adresse 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 utilisateurs accèdent après avoir cliqué sur l'annonce sur un appareil mobile.
finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL des pages 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 elle n'est pas définie, 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 elle n'est pas définie, la valeur par défaut sera appliquée.

DemandGenCarouselAd

Détails d'une annonce carrousel de génération de la demande.

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 utilisateurs 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 cartes affichées dans l'annonce.
finalUrlSuffix

string

Facultatif. Suffixe à ajouter aux URL des pages de destination.
trackingUrl

string

Uniquement en sortie. Adresse 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 elle n'est pas définie, 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 utilisateurs accèdent après avoir cliqué sur la fiche.
finalMobileUrl

string

Facultatif. Adresse 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.

Ne doit pas dépasser 10 caractères.
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 carte.

DemandGenProductAd

Informations détaillées 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 utilisateurs 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 des pages 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. Adresse 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 elle n'est pas définie, 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 de l'URL à afficher après le domaine.
displayUrlBreadcrumb2

string

Facultatif. Il s'agit du deuxième élément après le domaine dans l'URL à afficher.

AdPolicy

Règlement unique sur les annonces associé à 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 des règles d'une annonce, indiquant la décision d'approbation.
adPolicyReviewStatus

enum (AdPolicyReviewStatus)

État de l'examen des règles d'une annonce, indiquant où elle se trouve actuellement dans le processus d'examen.
adPolicyTopicEntry[]

object (AdPolicyTopicEntry)

Les entrées pour chaque thème de règlement identifié comme lié à l'annonce. Chaque entrée inclut le thème, le niveau de restriction et des conseils sur la façon de résoudre les problèmes liés aux règles.

AdPolicyApprovalStatus

États possibles de l'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 Les annonces seront diffusées avec des restrictions.
APPROVED Sera diffusée sans restrictions.
AREA_OF_INTEREST_ONLY Ne sera pas diffusée dans les pays ciblés, mais pourra l'être auprès des utilisateurs qui recherchent des informations sur ces pays.

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 L'examen principal est terminé. D'autres examens peuvent être en cours.
UNDER_APPEAL La création a été renvoyée pour approbation ou une décision liée au règlement a fait l'objet d'un appel.
ELIGIBLE_MAY_SERVE Elles sont considérées comme éligibles et peuvent être diffusées. Un examen plus approfondi pourra toujours avoir lieu.

AdPolicyTopicEntry

Entrée décrivant comment une annonce a été identifiée comme étant liée à des règles relatives 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ème de la règle.

Par exemple, "MARQUES DÉPOSÉES", "ALCOOL", etc.
policyLabel

string

Texte du libellé localisé pour le règlement.

Par exemple, "Marques déposées dans le texte", "Contient de l'alcool", etc.
policyTopicDescription

string

Brève description du thème des règles.
policyTopicType

enum (AdPolicyTopicEntryType)

L'impact sur la diffusion des annonces en raison de la relation avec le thème des règles relatives aux annonces.
policyDecisionType

enum (AdPolicyDecisionType)

Source de la décision liée aux règles.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

Moyen d'application des règles utilisé lors de l'examen des règles.
policyTopicEvidences[]

object (AdPolicyTopicEvidence)

Les preuves utilisées dans la décision liée aux règles.
policyTopicConstraints[]

object (AdPolicyTopicConstraint)

Contraintes de diffusion liées à la décision concernant les règles.
appealInfo

object (AdPolicyTopicAppealInfo)

Informations sur la procédure d'appel de la décision liée aux règles.

AdPolicyTopicEntryType

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

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 peut être diffusée auprès des utilisateurs qui recherchent des informations sur ces pays.

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 provient d'une notification légale, d'une ordonnance du tribunal, d'une réclamation du propriétaire d'une marque, etc.
GOOGLE_INVESTIGATION La décision provient d'une enquête appartenant à Google.

AdPolicyEnforcementMeans

Moyens possibles de mesure 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 Le processus d'application était entièrement automatisé.
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. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
textList

object (TextList)

Liste des éléments de preuve trouvés 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 "fr-FR".
destinationTextList

object (DestinationTextList)

Le texte de la destination de l'annonce qui enfreint les règles.
destinationMismatch

object (DestinationMismatch)

Une 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 liés à des marques qui ont entraîné un non-respect des règles.
legalRemoval

object (LegalRemoval)

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

object (Counterfeit)

Mesures d'application concernant la contrefaçon ayant entraîné un non-respect des règles.
regionalRequirements

object (RegionalRequirements)

Mesure d'application proactive de l'équipe Trust & Safety ayant entraîné un non-respect des règles.
Fin des champs qui s'excluent mutuellement.

TextList

Liste des fragments de texte qui ne respectent pas le règlement.

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

string

Fragments de texte de la ressource qui ont entraîné le résultat de la règle.

WebsiteList

Liste des sites Web qui ont enfreint le règlement.

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

string

Sites Web ayant entraîné le non-respect des règles.

DestinationTextList

Liste des textes de destination qui ne respectent pas le règlement.

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

string

Texte de la destination qui a entraîné le 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 à son URL finale.

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 ne fonctionne pas.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

Appareil sur lequel l'erreur s'est produite lors de la visite de l'URL.
lastCheckedTime

string (Timestamp format)

Dernière date à laquelle l'erreur a été constaté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. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul 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 qui s'excluent mutuellement.

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 susceptibles d'avoir 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.
ANDROID Un appareil Android.
IOS sur un appareil iOS.

Marque

Termes liés à des marques qui ont entraîné un non-respect des règles.

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

string

Propriétaire du contenu de la marque.
term

string

Terme de la marque.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

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

AdPolicyCriterionRestriction

Représente une restriction de pays.

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 des réglementations juridiques, qu'il s'agisse de la loi DMCA ou de réglementations juridiques 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 ayant entraîné la suppression pour motif légal.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

Pays où l'accès est limité en raison de la suppression pour motif légal
restrictedUris[]

string

URL limitées en raison de la suppression pour motif légal.
Informations sur le type de suppression pour motif légal. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
dmca

object (Dmca)

Détails sur la suppression pour motif légal en vertu de la loi DMCA.
Fin des champs qui s'excluent mutuellement.

DMCA

Informations sur la réclamation DMCA.

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

string

Entité ayant déposé la réclamation d'ordre juridique.

LocalLegal

Détails de la réglementation juridique locale.

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.

Ne s'applique qu'à la loi DMCA.
COURT_ORDER

Ordonnance du tribunal.

Ne s'applique qu'aux lois locales.

Contrefaçon

Détails sur l'application de la loi concernant la contrefaçon qui a entraîné un non-respect des règles.

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

string

Propriétaires du contenu ou du produit ayant déposé une réclamation

RegionalRequirements

Application proactive par Trust & Safety (T&S) des règles destinées à répondre aux exigences régionales. Il s'agit d'une enquête appartenant à Google et non d'un avis réglementaire, car il s'agit d'une application proactive des conditions d'utilisation et du règlement.

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

object (RegionalRequirementsEntry)

Liste des exigences régionales.

RegionalRequirementsEntry

Informations sur les cas de non-respect des règles régionales au niveau des règles.

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

string

Règle juridique qui n'a pas été respectée
countryRestrictions[]

object (AdPolicyCriterionRestriction)

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

AdPolicyTopicConstraint

Informations sur les contraintes de diffusion d'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. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul 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 où 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 y 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 des annonces dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce.
Fin des champs qui s'excluent mutuellement.

AdPolicyCountryConstraintList

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

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 lié aux règles a été limité, car le site Web a été refusé à des fins 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 des annonces dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce.

AdPolicyTopicAppealInfo

Informations sur la procédure d'appel d'une décision liée aux règles

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

enum (AdPolicyAppealType)

Indique si la décision peut faire l'objet d'un appel en libre-service ou via 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 cette décision en libre-service.
APPEAL_FORM Vous pouvez faire appel de cette décision à l'aide d'un formulaire d'appel.

AdUrl

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

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'annonce possibles.

Enums
AD_URL_TYPE_UNSPECIFIED Inconnu ou non spécifié.
AD_URL_TYPE_BEACON_IMPRESSION Pixel de suivi 1x1 à pinguer 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 étendu à plusieurs balises.
AD_URL_TYPE_BEACON_CLICK URL de suivi à envoyer lorsque l'événement de clic est déclenché.
AD_URL_TYPE_BEACON_SKIP URL de suivi à pinguer lorsque l'événement de désactivation 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

 Liste les annonces du groupe d'annonces.

patch

 Met à jour une annonce de groupe d'annonces.