REST Resource: customers.ads

FinalAppUrl

URL de lien profond vers une application pour le système d'exploitation donné.

Représentation JSON
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Champs
osType

enum (AppUrlOperatingSystemType)

Système d'exploitation ciblé par cette URL. Obligatoire.

url

string

URL du lien profond vers l'application. Les liens profonds spécifient un emplacement dans votre application qui correspond au contenu que vous souhaitez afficher. Ils doivent se présenter sous la forme {scheme}://{host_path}. Le schéma identifie l'application à ouvrir. Pour votre application, vous pouvez utiliser un schéma personnalisé qui commence par son nom. L'hôte et le chemin d'accès spécifient l'emplacement unique de votre contenu dans l'application. Exemple: "exampleapp://productid_1234". Obligatoire.

AppUrlOperatingSystemType

Système d'exploitation

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
IOS Le système d'exploitation Apple IOS.
ANDROID Le système d'exploitation Android

CustomParameter

Mappage pouvant être utilisé par les balises de paramètres personnalisés dans trackingUrlTemplate, finalUrls ou mobile_final_urls.

Représentation JSON
{
  "key": string,
  "value": string
}
Champs
key

string

Clé correspondant au nom du tag du paramètre.

value

string

Valeur à remplacer.

AdType

Types d'annonces possibles.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

TEXT_AD L'annonce est une annonce textuelle.
EXPANDED_TEXT_AD Il s'agit d'une annonce textuelle agrandie.
EXPANDED_DYNAMIC_SEARCH_AD L'annonce est une annonce dynamique agrandie du Réseau de Recherche.
HOTEL_AD L'annonce est une annonce d'hôtel.
SHOPPING_SMART_AD Il s'agit d'une annonce Shopping intelligente.
SHOPPING_PRODUCT_AD Il s'agit d'une annonce Shopping standard.
VIDEO_AD L'annonce est une annonce vidéo.
IMAGE_AD Cette annonce est une annonce illustrée.
RESPONSIVE_SEARCH_AD L'annonce est responsive sur le Réseau de Recherche.
LEGACY_RESPONSIVE_DISPLAY_AD L'annonce est une ancienne annonce display responsive.
APP_AD L'annonce est une annonce pour une application.
LEGACY_APP_INSTALL_AD L'annonce est une ancienne annonce incitant à installer une application.
RESPONSIVE_DISPLAY_AD L'annonce est une annonce display responsive.
LOCAL_AD L'annonce est une annonce locale.
HTML5_UPLOAD_AD L'annonce est une annonce display importée avec le type de produit HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD L'annonce est une annonce display à importer avec l'un des types de produits DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Il s'agit d'une annonce ciblant l'engagement avec une application.
SHOPPING_COMPARISON_LISTING_AD L'annonce est une annonce comparateur de prix Shopping.
VIDEO_BUMPER_AD Annonce vidéo bumper.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annonce vidéo InStream non désactivable.
VIDEO_OUTSTREAM_AD Annonce vidéo OutStream.
VIDEO_TRUEVIEW_IN_STREAM_AD Annonce vidéo TrueView InStream.
VIDEO_RESPONSIVE_AD Annonce vidéo responsive.
SMART_CAMPAIGN_AD Annonce pour une campagne intelligente.
CALL_AD Annonce Appel.
APP_PRE_REGISTRATION_AD Annonce universelle de préinscription à une application.
IN_FEED_VIDEO_AD Annonce vidéo In-Feed.
DISCOVERY_MULTI_ASSET_AD Annonce multi-élément Discovery.
TRAVEL_AD Annonce de voyage
DISCOVERY_VIDEO_RESPONSIVE_AD Annonce vidéo responsive pour Discovery.

Appareil

Énumère les appareils Google Ads disponibles pour le ciblage.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
MOBILE Mobiles dotés d'un navigateur Internet complet
TABLET Tablettes dotées d'un navigateur Internet complet
DESKTOP Ordinateurs.
CONNECTED_TV Smart TV et consoles de jeu.
OTHER Autres types d'appareils

UrlCollection

Ensemble d'URL taguées à l'aide d'un identifiant unique.

Représentation JSON
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
Champs
finalUrls[]

string

Une liste des URL finales possibles.

finalMobileUrls[]

string

Une liste des URL finales pour mobile possibles.

urlCollectionId

string

Identifiant unique de cette instance UrlCollection.

trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi.

SystemManagedResourceSource

Énumération répertoriant les sources possibles d'entités gérées par le système.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AD_VARIATIONS Annonce test de variantes d'annonces générée.

TextAdInfo

Annonce textuelle.

Représentation JSON
{
  "headline": string,
  "description1": string,
  "description2": string
}
Champs
headline

string

Titre de l'annonce.

description1

string

Première ligne de la description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

ExpandedTextAdInfo

Annonce textuelle agrandie.

Représentation JSON
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
Champs
headlinePart1

string

Première partie du titre de l'annonce

headlinePart2

string

Deuxième partie du titre de l'annonce.

headlinePart3

string

Troisième partie du titre de l'annonce

description

string

Description de l'annonce.

description2

string

Deuxième description de l'annonce.

path1

string

Texte qui peut s'afficher à côté de l'URL de l'annonce.

path2

string

Texte supplémentaire qui peut s'afficher à côté de l'URL de l'annonce.

CallAdInfo

Annonce Appel

Représentation JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Champs
countryCode

string

Le code pays de l'annonce.

phoneNumber

string

Numéro de téléphone dans l'annonce.

businessName

string

Nom de l'entreprise dans l'annonce.

headline1

string

Premier titre de l'annonce.

headline2

string

Deuxième titre de l'annonce.

description1

string

Première ligne de la description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

callTracked

boolean

Permet d'activer ou non le suivi des appels pour la création. L'activation du suivi des appels active également les conversions par appel.

disableCallConversion

boolean

Indique si la conversion par appel doit être désactivée pour la création. Si la valeur est true, les conversions par appel sont désactivées même si la valeur de callTracked est true. Si callTracked est défini sur false, ce champ est ignoré.

phoneNumberVerificationUrl

string

URL à utiliser pour la validation du numéro de téléphone.

conversionAction

string

Action de conversion à laquelle attribuer une conversion par appel. Si cette règle n'est pas configurée, une action de conversion par défaut est utilisée. Ce champ n'a d'effet que si callTracked est défini sur true. Sinon, ce champ est ignoré.

conversionReportingState

enum (CallConversionReportingState)

Comportement de conversion par appel de cette annonce Appel. Elle peut utiliser son propre paramètre de conversion par appel, hériter du paramètre au niveau du compte ou être désactivée.

path1

string

Première partie de texte pouvant être ajoutée à l'URL dans l'annonce. Facultatif.

path2

string

Deuxième partie de texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si path1 est également défini. Facultatif.

CallConversionReportingState

Types de données possibles pour un état d'action de conversion par appel.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DISABLED L'action de conversion par appel est désactivée.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION L'action de conversion par appel utilisera le type de conversion par appel défini au niveau du compte.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION L'action de conversion par appel utilisera le type de conversion par appel défini au niveau de la ressource (annonces Appel uniquement/extensions d'appel).

ExpandedDynamicSearchAdInfo

Annonce dynamique agrandie du Réseau de Recherche.

Représentation JSON
{
  "description": string,
  "description2": string
}
Champs
description

string

Description de l'annonce.

description2

string

Deuxième description de l'annonce.

HotelAdInfo

Ce type ne comporte aucun champ.

Annonce d'hôtel.

ShoppingSmartAdInfo

Ce type ne comporte aucun champ.

Annonce Shopping intelligente.

ShoppingProductAdInfo

Ce type ne comporte aucun champ.

Annonce Shopping standard.

ImageAdInfo

Annonce illustrée.

Représentation JSON
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "mediaFile": string,
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Champs
mimeType

enum (MimeType)

Type MIME de l'image.

pixelWidth

string (int64 format)

Largeur, en pixels, de l'image en taille réelle.

pixelHeight

string (int64 format)

Hauteur en pixels de l'image en taille réelle.

imageUrl

string

URL de l'image en taille réelle.

previewPixelWidth

string (int64 format)

Largeur, en pixels, de l'image dans la taille de l'aperçu.

previewPixelHeight

string (int64 format)

Hauteur en pixels de la taille de l'aperçu de l'image.

previewImageUrl

string

URL de l'image de la taille d'aperçu.

name

string

Nom de l'image. Si l'image a été créée à partir d'un élément MediaFile, il s'agit du nom de ce fichier. Si l'image a été créée à partir d'octets, ce champ est vide.

Champ d'union image. Image à partir de laquelle créer l'ImageAd. Vous pouvez le spécifier de deux manières. 1. Ressource MediaFile existante. 2. Données brutes de l'image, exprimées en octets. image ne peut être qu'un des éléments suivants :
mediaFile

string

Ressource MediaFile à utiliser pour l'image.

data

string (bytes format)

Données d'image brutes en octets.

Chaîne encodée en base64.

adIdToCopyImageFrom

string (int64 format)

Identifiant de l'annonce à partir de laquelle copier l'image.

MimeType

Type MIME

Enums
UNSPECIFIED Le type MIME n'a pas été spécifié.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

IMAGE_JPEG Type MIME de l'image/jpeg.
IMAGE_GIF Type MIME de l'image ou du GIF.
IMAGE_PNG Type MIME de l'image/png.
FLASH Type MIME de l'application/x-shockwave-flash.
TEXT_HTML Type MIME de text/html.
PDF Type MIME de l'application/pdf.
MSWORD Type MIME de l'application/msword.
MSEXCEL Type MIME de l'application application/vnd.ms-excel.
RTF Type MIME de l'application/rtf.
AUDIO_WAV Type MIME de l'audio/wav.
AUDIO_MP3 Type MIME de l'audio/mp3.
HTML5_AD_ZIP Type MIME de l'application application/x-html5-ad-zip.

VideoAdInfo

Annonce vidéo.

Représentation JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Champs
video

object (AdVideoAsset)

Assets vidéo YouTube utilisés pour l'annonce.

Champ d'union format. Schéma spécifique aux différents formats vidéo. format ne peut être qu'un des éléments suivants :
inStream

object (VideoTrueViewInStreamAdInfo)

Format d'annonce vidéo TrueView InStream

bumper

object (VideoBumperInStreamAdInfo)

Format d'annonce vidéo InStream bumper.

outStream

object (VideoOutstreamAdInfo)

Format d'annonce vidéo OutStream.

nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Format d'annonce vidéo InStream non désactivable.

inFeed

object (InFeedVideoAdInfo)

Format d'annonce vidéo In-Feed.

AdVideoAsset

Asset vidéo utilisé dans une annonce.

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

string

Nom de ressource de l'asset pour cette vidéo.

VideoTrueViewInStreamAdInfo

Représentation du format d'annonce vidéo TrueView InStream (annonce diffusée pendant la lecture d'une vidéo, souvent au début, avec un bouton "Ignorer" affiché pendant quelques secondes).

Représentation JSON
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
Champs
actionButtonLabel

string

Libellé du bouton d'incitation à l'action redirigeant l'utilisateur vers l'URL finale de l'annonce vidéo. Obligatoire pour les campagnes TrueView pour l'action, facultatif dans les autres cas.

actionHeadline

string

Texte supplémentaire affiché avec le bouton d'incitation à l'action pour fournir du contexte et encourager les utilisateurs à cliquer sur le bouton.

companionBanner

object (AdImageAsset)

Assets image de la bannière associée utilisée avec l'annonce.

AdImageAsset

Composant Image utilisé dans une annonce.

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

string

Nom de la ressource d'asset de cette image.

VideoBumperInStreamAdInfo

Représentation du format d'annonce vidéo InStream bumper (annonce vidéo InStream très courte non désactivable).

Représentation JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Champs
companionBanner

object (AdImageAsset)

Assets image de la bannière associée utilisée avec l'annonce.

actionButtonLabel

string

Libellé du bouton "Incitation à l'action" redirigeant l'utilisateur vers l'URL finale de l'annonce vidéo.

actionHeadline

string

Texte supplémentaire affiché avec le bouton d'incitation à l'action pour fournir du contexte et encourager les utilisateurs à cliquer sur le bouton.

VideoOutstreamAdInfo

Représentation du format d'annonce vidéo OutStream (annonce diffusée à côté d'un flux avec lecture automatique, sans son).

Représentation JSON
{
  "headline": string,
  "description": string
}
Champs
headline

string

Titre de l'annonce.

description

string

Ligne de description.

VideoNonSkippableInStreamAdInfo

Représentation du format d'annonce vidéo InStream non désactivable (annonce vidéo InStream non désactivable de 15 secondes).

Représentation JSON
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Champs
companionBanner

object (AdImageAsset)

Assets image de la bannière associée utilisée avec l'annonce.

actionButtonLabel

string

Libellé du bouton "Incitation à l'action" redirigeant l'utilisateur vers l'URL finale de l'annonce vidéo.

actionHeadline

string

Texte supplémentaire affiché avec le bouton "Incitation à l'action" pour fournir du contexte et inciter à cliquer sur le bouton.

InFeedVideoAdInfo

Représentation du format d'annonce vidéo In-Feed.

Représentation JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
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.

thumbnail

enum (VideoThumbnail)

Image miniature de la vidéo à utiliser.

VideoThumbnail

Énumération répertoriant les types possibles d'une miniature de vidéo.

Enums
UNSPECIFIED Le type n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur de réponse uniquement.
DEFAULT_THUMBNAIL Vignette par défaut. Elles peuvent être générées automatiquement ou mises en ligne 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.

VideoResponsiveAdInfo

Annonce vidéo responsive.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte utilisés pour le titre court. Actuellement, une seule valeur est acceptée pour le titre court.

longHeadlines[]

object (AdTextAsset)

Liste des composants texte utilisés pour le titre long. Actuellement, une seule valeur est acceptée pour le titre long.

descriptions[]

object (AdTextAsset)

Liste des composants texte utilisés pour la description. Actuellement, une seule valeur est acceptée pour la description.

callToActions[]

object (AdTextAsset)

Liste des composants texte utilisés pour le bouton (par exemple, le bouton "Incitation à l'action"). Actuellement, une seule valeur est acceptée pour le bouton.

videos[]

object (AdVideoAsset)

Liste des assets vidéo YouTube utilisés pour l'annonce. Actuellement, une seule valeur est acceptée pour l'asset vidéo YouTube.

companionBanners[]

object (AdImageAsset)

Liste des éléments image utilisés pour la bannière associée. Actuellement, une seule valeur est acceptée pour l'élément de bannière associée.

breadcrumb1

string

Première partie du texte qui apparaît dans l'annonce avec l'URL affichée

breadcrumb2

string

Deuxième partie du texte qui apparaît dans l'annonce avec l'URL affichée.

AdTextAsset

Asset texte utilisé dans une annonce.

Représentation JSON
{
  "pinnedField": enum (ServedAssetFieldType),
  "assetPerformanceLabel": enum (AssetPerformanceLabel),
  "policySummaryInfo": {
    object (AdAssetPolicySummary)
  },
  "text": string
}
Champs
pinnedField

enum (ServedAssetFieldType)

Champ épinglé de l'asset. Ainsi, le composant ne sera diffusé que dans ce champ. Vous pouvez épingler plusieurs composants au même champ. Un élément retiré ou épinglé à un autre champ ne s'affichera pas dans un champ où un autre élément a été épinglé.

assetPerformanceLabel

enum (AssetPerformanceLabel)

Libellé de performances de ce composant texte.

policySummaryInfo

object (AdAssetPolicySummary)

Résumé des règles de cet élément texte.

text

string

Texte de l'asset.

ServedAssetFieldType

Types de champs d'éléments possibles.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

HEADLINE_1 Le composant est utilisé dans le titre 1.
HEADLINE_2 Le composant est utilisé dans le titre 2.
HEADLINE_3 Le composant est utilisé dans le titre 3.
DESCRIPTION_1 L'élément est utilisé dans la description 1.
DESCRIPTION_2 L'asset est utilisé dans la description 2.
CALL Ce composant est utilisé pour un appel.
MOBILE_APP Ce composant est utilisé en tant qu'application mobile.
CALLOUT Ce composant est utilisé en tant qu'accroche.
STRUCTURED_SNIPPET Ce composant est utilisé comme extrait structuré.
PRICE Ce composant est utilisé comme prix.
PROMOTION Ce composant est utilisé comme promotion.
AD_IMAGE Ce composant est utilisé en tant qu'image.
LEAD_FORM Le composant est utilisé comme formulaire pour prospects.

AssetPerformanceLabel

Énumération décrivant les libellés de performances possibles d'un composant, généralement calculé dans le contexte d'une association.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
PENDING Cet élément ne dispose pas encore d'informations sur les performances. Il est possible qu'elle soit toujours en cours d'examen.
LEARNING L'asset a commencé à générer des impressions, mais les statistiques ne sont pas suffisamment pertinentes d'un point de vue statistique pour obtenir un libellé de performances.
LOW Composants les moins performants.
GOOD Composants performants.
BEST Composants les plus performants.

AdAssetPolicySummary

Contient des informations sur les règles relatives à un élément inclus dans une annonce.

Représentation JSON
{
  "policyTopicEntries": [
    {
      object (PolicyTopicEntry)
    }
  ],
  "reviewStatus": enum (PolicyReviewStatus),
  "approvalStatus": enum (PolicyApprovalStatus)
}
Champs
policyTopicEntries[]

object (PolicyTopicEntry)

Liste des résultats concernant les règles pour cet élément.

reviewStatus

enum (PolicyReviewStatus)

Emplacement du processus d'examen pour ce composant.

approvalStatus

enum (PolicyApprovalStatus)

État d'approbation général de ce composant, calculé en fonction de l'état des différentes entrées concernant des thèmes de règles spécifiques.

PolicyTopicEntry

Constatation liée à une ressource (par exemple, la règle associée à un site qui vend de l'alcool)

Chaque PolicyTopicEntry est associée à un sujet qui indique le règlement spécifique relatif aux annonces concerné, ainsi qu'un type indiquant son effet sur la diffusion. Il peut éventuellement comporter une ou plusieurs preuves indiquant la raison du résultat. Elle peut également comporter une ou plusieurs contraintes indiquant comment la diffusion peut être limitée.

Représentation JSON
{
  "type": enum (PolicyTopicEntryType),
  "evidences": [
    {
      object (PolicyTopicEvidence)
    }
  ],
  "constraints": [
    {
      object (PolicyTopicConstraint)
    }
  ],
  "topic": string
}
Champs
type

enum (PolicyTopicEntryType)

Décrit l'impact négatif ou positif de cette règle sur la diffusion.

evidences[]

object (PolicyTopicEvidence)

Informations supplémentaires expliquant le résultat d'un cas de non-respect des règles (par exemple, le nom d'une marque)

constraints[]

object (PolicyTopicConstraint)

Indique les conséquences sur la diffusion de cette ressource (par exemple, si elle n'est pas diffusée dans un pays).

topic

string

Sujet de la règle auquel ce résultat fait référence. Par exemple, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" ou "DESTINATION_NOT_WORKING". L'ensemble des thèmes de règles possibles n'est pas corrigé pour une version particulière de l'API et peut être modifié à tout moment.

PolicyTopicEntryType

Types d'entrées de thèmes de règles possibles.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

PROHIBITED La ressource ne sera pas diffusée.
LIMITED Dans certaines circonstances, la ressource ne sera pas diffusée.
FULLY_LIMITED La ressource ne peut pas du tout être diffusée en raison des critères de ciblage actuels.
DESCRIPTIVE Peut présenter un intérêt, mais ne limite pas le mode de diffusion de la ressource.
BROADENING Augmentation de la couverture au-delà de la normale.
AREA_OF_INTEREST_ONLY Limite pour tous les pays ciblés, mais peut être diffusée dans d'autres pays en fonction de la zone d'intérêt.

PolicyTopicEvidence

Informations supplémentaires expliquant un résultat de non-respect des règles.

Représentation JSON
{

  // Union field value can be only one of the following:
  "websiteList": {
    object (WebsiteList)
  },
  "textList": {
    object (TextList)
  },
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  }
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Informations spécifiques aux preuves en fonction du type de preuve. value ne peut être qu'un des éléments suivants :
websiteList

object (WebsiteList)

Liste des sites Web liés à cette ressource.

textList

object (TextList)

Liste de preuves trouvées dans le texte d'une ressource.

languageCode

string

Langue dans laquelle la ressource a été détectée. Il s'agit d'un tag de langue IETF (par exemple, "en-US").

destinationTextList

object (DestinationTextList)

Texte de la destination de la ressource à l'origine d'un résultat de stratégie.

destinationMismatch

object (DestinationMismatch)

Les destinations des URL d'une ressource ne correspondent pas.

destinationNotWorking

object (DestinationNotWorking)

Informations détaillées lorsque la destination renvoie un code d'erreur HTTP ou ne fonctionne pas dans toutes les zones géographiques des appareils couramment utilisés

WebsiteList

Liste des sites Web à l'origine d'un résultat de non-respect des règles. Utilisé pour le thème de règle ONE_WEBSITE_PER_AD_GROUP, par exemple. S'il y a plus de cinq sites Web, seuls les cinq premiers (ceux qui figurent le plus dans les ressources) sont listés ici.

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

string

Sites Web à l'origine du résultat du règlement.

TextList

Liste des fragments de texte qui ne respectent pas une règle.

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

string

Fragments de texte de la ressource à l'origine du résultat de la règle.

DestinationTextList

Liste de chaînes sur une page de destination ayant entraîné un résultat de non-respect des règles.

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

string

Liste des textes trouvés sur la page de destination de la ressource.

DestinationMismatch

Preuve de non-concordance des URL d'une ressource.

Représentation JSON
{
  "urlTypes": [
    enum (PolicyTopicEvidenceDestinationMismatchUrlType)
  ]
}
Champs
urlTypes[]

enum (PolicyTopicEvidenceDestinationMismatchUrlType)

Ensemble d'URL qui ne correspondent pas.

PolicyTopicEvidenceDestinationMismatchUrlType

Types d'URL de destination possibles pour la preuve du règlement.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

DISPLAY_URL URL à afficher
FINAL_URL URL finale.
FINAL_MOBILE_URL URL finale pour mobile.
TRACKING_URL Modèle d'URL de suivi, avec l'URL pour ordinateur remplacée.
MOBILE_TRACKING_URL Modèle d'URL de suivi, avec l'URL mobile remplacée.

DestinationNotWorking

Données probantes lorsque la destination renvoie un code d'erreur HTTP ou ne fonctionne pas dans toutes les zones géographiques des appareils couramment utilisés.

Représentation JSON
{
  "device": enum (PolicyTopicEvidenceDestinationNotWorkingDevice),
  "expandedUrl": string,
  "lastCheckedDateTime": string,

  // Union field reason can be only one of the following:
  "dnsErrorType": enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType),
  "httpErrorCode": string
  // End of list of possible types for union field reason.
}
Champs
device

enum (PolicyTopicEvidenceDestinationNotWorkingDevice)

Type d'appareil pour lequel l'URL n'a pas pu être chargée.

expandedUrl

string

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

lastCheckedDateTime

string

Heure de la dernière vérification de l'URL. Le format est "AAAA-MM-JJ HH:MM:SS". Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"

Champ d'union reason. Indique la raison du résultat de la règle DESTINATION_NOT_WORKING. reason ne peut être qu'un des éléments suivants :
dnsErrorType

enum (PolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Type d'erreur DNS.

httpErrorCode

string (int64 format)

Code d'erreur HTTP.

PolicyTopicEvidenceDestinationNotWorkingDevice

La destination potentielle des preuves concernant le sujet du règlement ne fonctionne pas sur les appareils.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

DESKTOP La page de destination ne fonctionne pas sur les ordinateurs.
ANDROID La page de destination ne fonctionne pas sur les appareils Android.
IOS La page de destination ne fonctionne pas sur les appareils iOS.

PolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Types d'erreurs DNS possibles pour la destination de preuve du sujet de la règle qui ne fonctionne pas.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

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 Problème avec le robot d'exploration interne de Google lors de la communication avec le DNS. Cette erreur ne signifie pas que la page de destination ne fonctionne pas. Google réexplorera la page de destination.

PolicyTopicConstraint

Décrit l'effet d'une entrée de sujet de règle sur l'inférence.

Représentation JSON
{

  // Union field value can be only one of the following:
  "countryConstraintList": {
    object (CountryConstraintList)
  },
  "resellerConstraint": {
    object (ResellerConstraint)
  },
  "certificateMissingInCountryList": {
    object (CountryConstraintList)
  },
  "certificateDomainMismatchInCountryList": {
    object (CountryConstraintList)
  }
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Informations spécifiques sur la contrainte. value ne peut être qu'un des éléments suivants :
countryConstraintList

object (CountryConstraintList)

Pays dans lesquels la ressource ne peut pas être diffusée.

resellerConstraint

object (ResellerConstraint)

Contrainte revendeur.

certificateMissingInCountryList

object (CountryConstraintList)

Pays dans lesquels un certificat est requis pour la diffusion.

certificateDomainMismatchInCountryList

object (CountryConstraintList)

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

CountryConstraintList

Liste des pays où la diffusion d'une ressource est limitée.

Représentation JSON
{
  "countries": [
    {
      object (CountryConstraint)
    }
  ],
  "totalTargetedCountries": integer
}
Champs
countries[]

object (CountryConstraint)

Pays dans lesquels la diffusion est limitée.

totalTargetedCountries

integer

Nombre total de pays ciblés par la ressource.

CountryConstraint

Indique que la capacité d'une ressource à être diffusée dans un pays particulier est limitée.

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

string

Nom de ressource constant de la cible géographique du pays dans lequel la diffusion est limitée.

ResellerConstraint

Ce type ne comporte aucun champ.

Des restrictions ont été appliquées à un sujet du règlement, car le site Web a été refusé à des fins de revendeur.

PolicyReviewStatus

États possibles de vérification du respect des règles.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

REVIEW_IN_PROGRESS En cours d'examen.
REVIEWED Examen principal terminé. D'autres examens peuvent se poursuivre.
UNDER_APPEAL La ressource a été renvoyée pour approbation, ou vous avez fait appel de sa décision liée aux règles.
ELIGIBLE_MAY_SERVE La ressource est éligible et peut être diffusée, mais elle peut encore faire l'objet d'un examen plus approfondi.

PolicyApprovalStatus

États d'approbation des règles possibles. Lorsque plusieurs états d'approbation sont disponibles, le plus grave est utilisé. L'ordre de gravité est DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED et APPROVED.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

DISAPPROVED Ne sera pas diffusé.
APPROVED_LIMITED Diffusion soumise à des restrictions.
APPROVED Diffusion 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 les pays ciblés.

ResponsiveSearchAdInfo

Annonce responsive sur le Réseau de Recherche.

Les annonces responsives sur le Réseau de Recherche s'adaptent de manière à afficher plus de texte et un message plus pertinent auprès de vos clients. Lorsque vous créez ce type d'annonce, saisissez plusieurs titres et descriptions. Google Ads testera automatiquement différentes combinaisons au fil du temps afin d'identifier les plus performantes. En adaptant leur contenu aux termes de recherche saisis par vos clients potentiels, les annonces responsives sur le Réseau de Recherche peuvent améliorer les performances de votre campagne.

Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/7684791.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste.

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste.

path1

string

Première partie de texte pouvant être ajoutée à l'URL dans l'annonce.

path2

string

Deuxième partie de texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si path1 est également défini.

LegacyResponsiveDisplayAdInfo

Ancienne annonce display responsive. Les annonces de ce type sont signalées par le libellé "Annonces responsives" dans l'interface utilisateur Google Ads.

Représentation JSON
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Champs
formatSetting

enum (DisplayAdFormatSetting)

Spécifie le format dans lequel l'annonce sera diffusée. La valeur par défaut est ALL_FORMATS.

shortHeadline

string

Version courte du titre de l'annonce.

longHeadline

string

Version longue du titre de l'annonce.

description

string

Description de l'annonce.

businessName

string

Nom de l'entreprise dans l'annonce.

allowFlexibleColor

boolean

Consentement de l'annonceur autorisant la couleur flexible. Lorsque la valeur est "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce est diffusée dans les couleurs spécifiées ou dans une couleur neutre. La valeur par défaut est true. Doit être "true" si mainColor et accentColor ne sont pas définis.

accentColor

string

Couleur d'accentuation de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si mainColor et accentColor sont définis, l'autre est également obligatoire.

mainColor

string

Couleur principale de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si mainColor et accentColor sont définis, l'autre est également obligatoire.

callToActionText

string

Texte d'incitation à l'action de l'annonce.

logoImage

string

Nom de ressource MediaFile de l'image du logo utilisée dans l'annonce.

squareLogoImage

string

Nom de ressource MediaFile de l'image du logo carré utilisée dans l'annonce.

marketingImage

string

Nom de ressource MediaFile de l'image marketing utilisée dans l'annonce.

squareMarketingImage

string

Nom de ressource MediaFile de l'image marketing carrée utilisée dans l'annonce.

pricePrefix

string

Préfixe avant le prix. Par exemple, "aussi bas que".

promoText

string

Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h").

DisplayAdFormatSetting

Énumère les paramètres du format d'annonce display.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
ALL_FORMATS Annonces textuelles, illustrées et natives.
NON_NATIVE Formats textuels et illustrés.
NATIVE Le format natif (par exemple, le rendu du format est contrôlé par l'éditeur et non par Google).

AppAdInfo

Annonce pour une application.

Représentation JSON
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ]
}
Champs
mandatoryAdText

object (AdTextAsset)

Texte d'annonce obligatoire.

headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste.

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste.

images[]

object (AdImageAsset)

Liste des composants Image pouvant être affichés avec l'annonce.

youtubeVideos[]

object (AdVideoAsset)

Liste des assets vidéo YouTube pouvant être affichés avec l'annonce.

html5MediaBundles[]

object (AdMediaBundleAsset)

Liste des éléments du kit média qui peuvent être utilisés avec l'annonce.

AdMediaBundleAsset

Asset de kit média utilisé dans une annonce.

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

string

Nom de ressource de l'asset de ce kit média.

LegacyAppInstallAdInfo

Une ancienne annonce incitant à installer une application qui ne peut être utilisée que par un nombre limité de clients.

Représentation JSON
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Champs
appStore

enum (LegacyAppInstallAdAppStore)

Plate-forme de téléchargement d'applications dans laquelle l'application mobile est disponible.

appId

string

ID de l'application mobile.

headline

string

Titre de l'annonce.

description1

string

Première ligne de description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

LegacyAppInstallAdAppStore

Type de plate-forme de téléchargement d'applications dans une ancienne annonce incitant à installer une application.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE Windows Phone Store.
CN_APP_STORE L'application est hébergée sur une plate-forme de téléchargement d'applications chinoise.

ResponsiveDisplayAdInfo

Une annonce display responsive.

Représentation JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Champs
marketingImages[]

object (AdImageAsset)

Images marketing à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 600 x 314 et le format doit être 1.91:1 (+-1%). Veuillez indiquer au moins un élément marketingImage. Combinée à squareMarketingImages, la valeur maximale est de 15.

squareMarketingImages[]

object (AdImageAsset)

Images marketing carrées à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 300 x 300, et le format doit être 1:1 (+-1%). Au moins un élément marketingImage carré est requis. Combinée à marketingImages, la valeur maximale est de 15.

logoImages[]

object (AdImageAsset)

Images de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 512 x 128 et le format doit être 4:1 (+-1%). Si elle est associée à squareLogoImages, la valeur maximale est de 5.

squareLogoImages[]

object (AdImageAsset)

Images de logos carrées à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128, et le format doit être 1:1 (+-1%). Si elle est associée à logoImages, la valeur maximale est de 5.

headlines[]

object (AdTextAsset)

Titres courts pour l'annonce. Il ne doit pas dépasser 30 caractères. Vous pouvez spécifier entre un et cinq titres.

longHeadline

object (AdTextAsset)

Titre long obligatoire. Il ne doit pas dépasser 90 caractères.

descriptions[]

object (AdTextAsset)

Textes descriptifs de l'annonce. Il ne doit pas dépasser 90 caractères. Vous pouvez spécifier entre un et cinq titres.

youtubeVideos[]

object (AdVideoAsset)

Vidéos YouTube facultatives pour l'annonce. Vous pouvez spécifier jusqu'à cinq vidéos.

formatSetting

enum (DisplayAdFormatSetting)

Spécifie le format dans lequel l'annonce sera diffusée. La valeur par défaut est ALL_FORMATS.

controlSpec

object (ResponsiveDisplayAdControlSpec)

Spécifications pour différentes commandes de création.

businessName

string

Nom de l'annonceur ou de la marque. La largeur d'affichage maximale est de 25.

mainColor

string

Couleur principale de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si mainColor et accentColor sont définis, l'autre est également obligatoire.

accentColor

string

Couleur d'accentuation de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si mainColor et accentColor sont définis, l'autre est également obligatoire.

allowFlexibleColor

boolean

Consentement de l'annonceur autorisant la couleur flexible. Lorsque la valeur est "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce est diffusée dans les couleurs spécifiées ou dans une couleur neutre. La valeur par défaut est true. Doit être "true" si mainColor et accentColor ne sont pas définis.

callToActionText

string

Texte d'incitation à l'action de l'annonce. La largeur d'affichage maximale est de 30.

pricePrefix

string

Préfixe avant le prix. Par exemple, "aussi bas que".

promoText

string

Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h").

ResponsiveDisplayAdControlSpec

Spécifications concernant les différentes commandes de création d'une annonce display responsive.

Représentation JSON
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
Champs
enableAssetEnhancements

boolean

Indique si l'annonceur a activé la fonctionnalité d'amélioration des assets.

enableAutogenVideo

boolean

Indique si l'annonceur a activé la fonctionnalité vidéo de génération automatique.

LocalAdInfo

Annonce locale.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste. Vous devez spécifier entre un et cinq titres.

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste. Vous devez saisir entre une et cinq descriptions.

callToActions[]

object (AdTextAsset)

Liste des composants texte pour les incitations à l'action. Lorsque l'annonce sera diffusée, les incitations à l'action seront sélectionnées dans cette liste. Vous devez spécifier entre une et cinq incitations à l'action.

marketingImages[]

object (AdImageAsset)

Liste des composants Image marketing pouvant être affichés avec l'annonce. Les images doivent mesurer 314 x 600 pixels ou 320 x 320 pixels. Vous devez spécifier entre 1 et 20 composants Image.

logoImages[]

object (AdImageAsset)

Liste des composants Image du logo pouvant être affichés avec l'annonce. Les images doivent faire 128 x 128 pixels et ne pas dépasser 120 ko. Vous devez spécifier entre un et cinq composants Image.

videos[]

object (AdVideoAsset)

Liste des assets vidéo YouTube pouvant être affichés avec l'annonce. Vous devez spécifier entre un et 20 assets vidéo.

path1

string

Première partie de texte facultatif qui peut être ajouté à l'URL dans l'annonce.

path2

string

Deuxième partie du texte facultatif qui peut être ajouté à l'URL dans l'annonce. Ce champ ne peut être défini que si path1 est également défini.

DisplayUploadAdInfo

Type d'annonce display générique. Le format exact est contrôlé par le champ displayUploadProductType, qui détermine les types de données à inclure dans l'annonce.

Représentation JSON
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Champs
displayUploadProductType

enum (DisplayUploadProductType)

Type de produit de cette annonce. Pour en savoir plus, consultez les commentaires de l'énumération.

Champ d'union media_asset. Données des composants qui composent l'annonce. media_asset ne peut être qu'un des éléments suivants :
mediaBundle

object (AdMediaBundleAsset)

Asset de kit média à utiliser dans l'annonce. Pour en savoir plus sur le kit média pour HTML5_UPLOAD_AD, consultez l'article https://support.google.com/google-ads/answer/1722096 Les kits média qui font partie de types de produits dynamiques utilisent un format spécial qui doit être créé via Google Web Designer. Pour en savoir plus, consultez la page https://support.google.com/webdesigner/answer/7543898.

DisplayUploadProductType

Énumère les types de produits display à importer.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
HTML5_UPLOAD_AD Annonce HTML5 à importer. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo.
DYNAMIC_HTML5_EDUCATION_AD Annonce pédagogique HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne éducative.
DYNAMIC_HTML5_FLIGHT_AD Annonce HTML5 dynamique pour la diffusion d'annonces. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne de diffusion.
DYNAMIC_HTML5_HOTEL_RENTAL_AD Annonce HTML5 dynamique pour hôtels et locations. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne d'hôtel.
DYNAMIC_HTML5_JOB_AD Annonce d'emploi HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne d'offres d'emploi.
DYNAMIC_HTML5_LOCAL_AD Annonce locale HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne locale.
DYNAMIC_HTML5_REAL_ESTATE_AD Annonce immobilière HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne immobilière.
DYNAMIC_HTML5_CUSTOM_AD Annonce HTML5 personnalisée dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne personnalisée.
DYNAMIC_HTML5_TRAVEL_AD Annonce de voyage HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne de voyage.
DYNAMIC_HTML5_HOTEL_AD Annonce d'hôtel HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne d'hôtel.

AppEngagementAdInfo

Les annonces ciblant l'engagement avec une application vous permettent de rédiger un texte encourageant une action spécifique dans l'application, comme faire son check-in, effectuer un achat ou réserver un billet d'avion. Elles vous permettent de rediriger les utilisateurs vers une section spécifique de votre application où ils peuvent trouver plus facilement et plus rapidement ce qu'ils cherchent.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste.

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste.

images[]

object (AdImageAsset)

Liste des composants Image pouvant être affichés avec l'annonce.

videos[]

object (AdVideoAsset)

Liste des assets vidéo pouvant être affichés avec l'annonce.

ShoppingComparisonListingAdInfo

Annonce comparateur de prix Shopping.

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

string

Titre de l'annonce Ce champ est obligatoire. La longueur autorisée est comprise entre 25 et 45 caractères.

SmartCampaignAdInfo

Annonce pour une campagne intelligente.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ]
}
Champs
headlines[]

object (AdTextAsset)

Liste de composants texte, chacun correspondant à un titre lors de la diffusion de l'annonce. Cette liste comprend entre 3 et 15 composants texte.

descriptions[]

object (AdTextAsset)

Liste des composants texte, chacun correspondant à une description lors de la diffusion de l'annonce. Cette liste comprend entre deux et quatre composants texte.

AppPreRegistrationAdInfo

Les annonces de préinscription à une application redirigent les utilisateurs vers la fiche de votre application ou de votre jeu sur Google Play. Elles peuvent être diffusées sur Google Play, sur YouTube (InStream uniquement), ainsi que sur d'autres applications et sites Web mobiles du Réseau Display. Cela vous aidera à susciter l'intérêt des utilisateurs pour votre application ou votre jeu et à générer une base d'installation anticipée pour votre application ou votre jeu avant son lancement.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste.

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste.

images[]

object (AdImageAsset)

Liste des ID de composants Image dont les images peuvent s'afficher avec l'annonce.

youtubeVideos[]

object (AdVideoAsset)

Liste des ID d'éléments vidéo YouTube dont les vidéos peuvent être diffusées avec l'annonce.

DiscoveryMultiAssetAdInfo

Annonce Discovery à plusieurs éléments.

Représentation JSON
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Champs
marketingImages[]

object (AdImageAsset)

Composants Image marketing à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 600 x 314 et le format doit être 1.91:1 (+-1%). Obligatoire si squareMarketingImages n'est pas présent. Combinée à squareMarketingImages et portraitMarketingImages, la valeur maximale est de 20.

squareMarketingImages[]

object (AdImageAsset)

Composants Image marketing carrée à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 300 x 300, et le format doit être 1:1 (+-1%). Obligatoire si marketingImages n'est pas présent. Combinée à marketingImages et portraitMarketingImages, la valeur maximale est de 20.

portraitMarketingImages[]

object (AdImageAsset)

Composants Image marketing en mode portrait à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 480 x 600, et le format doit être 4:5 (+-1%). Combinée à marketingImages et squareMarketingImages, la valeur maximale est de 20.

logoImages[]

object (AdImageAsset)

Composants Image de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128, et le format doit être 1:1 (+-1%). Vous pouvez spécifier entre une et cinq images de logo.

headlines[]

object (AdTextAsset)

Composant texte de titre de l'annonce. La largeur d'affichage maximale est de 30. Vous pouvez spécifier entre un et cinq titres.

descriptions[]

object (AdTextAsset)

Texte descriptif de l'annonce. La largeur d'affichage maximale est de 90. Vous pouvez saisir entre une et cinq descriptions.

businessName

string

Nom de l'annonceur ou de la marque. La largeur d'affichage maximale est de 25. Obligatoire.

callToActionText

string

Texte d'incitation à l'action.

leadFormOnly

boolean

Option booléenne qui indique si cette annonce doit être diffusée avec un formulaire pour prospects.

DiscoveryCarouselAdInfo

Annonce carrousel Discovery.

Représentation JSON
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDiscoveryCarouselCardAsset)
    }
  ]
}
Champs
businessName

string

Obligatoire. Nom de l'annonceur ou de la marque.

logoImage

object (AdImageAsset)

Obligatoire. Image du logo à utiliser dans l'annonce. La taille minimale est 128 x 128, et le format doit être 1:1 (+-1%).

headline

object (AdTextAsset)

Obligatoire. Titre de l'annonce

description

object (AdTextAsset)

Obligatoire. Texte descriptif de l'annonce.

callToActionText

string

Texte d'incitation à l'action.

carouselCards[]

object (AdDiscoveryCarouselCardAsset)

Obligatoire. Fiches de carrousel qui s'afficheront avec l'annonce. 2 au minimum, 10 au maximum.

AdDiscoveryCarouselCardAsset

Élément de fiche de carrousel Discovery utilisé dans une annonce.

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

string

Nom de la ressource d'asset de cette fiche de carrousel Discovery.

DiscoveryVideoResponsiveAdInfo

Annonce vidéo Discovery responsive.

Représentation JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte utilisés pour le titre court.

longHeadlines[]

object (AdTextAsset)

Liste des composants texte utilisés pour le titre long.

descriptions[]

object (AdTextAsset)

Liste des composants texte utilisés pour la description.

videos[]

object (AdVideoAsset)

Liste des assets vidéo YouTube utilisés pour l'annonce.

logoImages[]

object (AdImageAsset)

Image du logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128, et le format doit être 1:1 (+-1%).

breadcrumb1

string

Première partie du texte qui apparaît dans l'annonce avec l'URL affichée

breadcrumb2

string

Deuxième partie du texte qui apparaît dans l'annonce avec l'URL affichée.

businessName

object (AdTextAsset)

Obligatoire. Nom de l'annonceur ou de la marque.

callToActions[]

object (AdCallToActionAsset)

Composants de type CallToActionAsset utilisés pour le bouton "Incitation à l'action".

AdCallToActionAsset

Composant d'incitation à l'action utilisé dans une annonce.

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

string

Nom de ressource de ce composant d'incitation à l'action.

TravelAdInfo

Ce type ne comporte aucun champ.

Annonce de voyage

Méthodes

get

Affiche l'annonce demandée dans les moindres détails.

mutate

Met à jour les annonces.