- Ressource : AdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Miniature
- VideoPerformanceAd
- DemandGenVideoAd
- CallToAction
- DemandGenImageAd
- DemandGenCarouselAd
- CarouselCard
- DemandGenProductAd
- AdPolicy
- AdPolicyApprovalStatus
- AdPolicyReviewStatus
- AdPolicyTopicEntry
- AdPolicyTopicEntryType
- AdPolicyDecisionType
- AdPolicyEnforcementMeans
- AdPolicyTopicEvidence
- TextList
- WebsiteList
- DestinationTextList
- DestinationMismatch
- AdPolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
- Marque
- AdPolicyCriterionRestriction
- LegalRemoval
- Dmca
- LocalLegal
- AdPolicyTopicEvidenceLegalRemovalComplaintType
- Contrefaçon
- RegionalRequirements
- RegionalRequirementsEntry
- AdPolicyTopicConstraint
- AdPolicyCountryConstraintList
- AdPolicyResellerConstraint
- AdPolicyGlobalCertificateMissingConstraint
- AdPolicyGlobalCertificateDomainMismatchConstraint
- AdPolicyTopicAppealInfo
- AdPolicyAppealType
- AdUrl
- AdUrlType
- DcmTrackingInfo
- Méthodes
Ressource : AdGroupAd
Annonce unique associée à un groupe d'annonces.
| Représentation JSON |
|---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "adPolicy": { object ( |
| Champs | |
|---|---|
name |
Uniquement en sortie. Nom de ressource de l'annonce. |
advertiserId |
Uniquement en sortie. Identifiant unique de l'annonceur auquel l'annonce appartient. |
adGroupAdId |
Uniquement en sortie. Identifiant unique de l'annonce. Attribué par le système. |
adGroupId |
Obligatoire. Immuable. Identifiant unique du groupe d'annonces auquel appartient l'annonce. |
displayName |
Obligatoire. Nom à afficher de l'annonce. Doit être encodé en UTF-8 et ne pas dépasser 255 octets. |
adPolicy |
Uniquement en sortie. État d'approbation de l'annonce par rapport aux règles. |
entityStatus |
Obligatoire. État de l'entité de l'annonce. |
adUrls[] |
Uniquement en sortie. Liste des URL utilisées par l'annonce. |
dcmTrackingInfo |
Facultatif. les informations sur l'annonce de suivi DCM ; Pour supprimer les informations sur l'annonce de suivi DCM, veuillez laisser ce champ vide. |
containsSyntheticMedia |
Facultatif. Indique si l'annonce contient des médias modifiés ou synthétiques. Ne doit être défini que pour les annonces créées par des annonceurs électoraux validés. Valable uniquement pour les annonces YouTube. |
parentCreativeId |
Uniquement en sortie. ID de la création Display & Video 360 utilisée pour générer cette annonce. Ce champ ne sera renseigné que pour les annonces générées à partir de créations attribuées au groupe d'annonces parent. |
| Détails de l'annonce. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
displayVideoSourceAd |
Uniquement en sortie. Détails d'une annonce provenant d'une création Display & Video 360. |
mastheadAd |
Uniquement en sortie. Détails d'une annonce diffusée dans le flux d'accueil YouTube. |
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 |
Uniquement en sortie. Détails d'une annonce vidéo InStream courte non désactivable, d'une durée de 6 à 15 secondes, utilisée pour atteindre des objectifs marketing de couverture. |
bumperAd |
Uniquement en sortie. Détails d'une annonce vidéo courte non désactivable, d'une durée inférieure ou égale à six secondes, utilisée pour la couverture. |
audioAd |
Uniquement en sortie. Détails d'une annonce audio utilisée pour atteindre des objectifs marketing de couverture. |
videoDiscoverAd |
Uniquement en sortie. Détails d'une annonce promouvant une vidéo qui s'affiche dans les emplacements de découverte. |
videoPerformanceAd |
Uniquement en sortie. Détails d'une annonce utilisée dans une campagne vidéo pour l'action afin de générer des actions en lien avec l'entreprise, le service ou le produit. |
demandGenVideoAd |
Facultatif. Détails d'une annonce vidéo Demand Gen. |
demandGenImageAd |
Facultatif. Détails d'une annonce illustrée Demand Gen. |
demandGenCarouselAd |
Facultatif. Détails d'une annonce carrousel Demand Gen. |
demandGenProductAd |
Facultatif. Informations détaillées sur une annonce produit Demand Gen. |
| Fin des champs mutuellement exclusifs. | |
DisplayVideoSourceAd
Annonce provenant d'une création DV360.
| Représentation JSON |
|---|
{ "creativeId": string } |
| Champs | |
|---|---|
creativeId |
ID de la création source. |
MastheadAd
Informations sur une bannière Masthead.
| Représentation JSON |
|---|
{ "video": { object ( |
| Champs | |
|---|---|
video |
Vidéo YouTube utilisée par l'annonce. |
headline |
Titre de l'annonce. |
description |
Description de l'annonce. |
videoAspectRatio |
Format de la vidéo YouTube en lecture automatique dans le masthead. |
autoplayVideoStartMillisecond |
Durée en millisecondes après laquelle la lecture de la vidéo commence. |
autoplayVideoDuration |
Durée de la lecture automatique de la vidéo. Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par " |
callToActionButtonLabel |
Texte du bouton d'incitation à l'action. |
callToActionFinalUrl |
URL de destination du bouton d'incitation à l'action. |
callToActionTrackingUrl |
URL de suivi du bouton d'incitation à l'action. |
showChannelArt |
Indique si un arrière-plan ou une bannière s'affiche en haut d'une page YouTube. |
companionYoutubeVideos[] |
Vidéos s'affichant à côté de la bannière Masthead sur ordinateur. Ne peut pas comporter plus de deux chiffres après la virgule. |
YoutubeVideoDetails
Informations sur une vidéo YouTube.
| Représentation JSON |
|---|
{
"id": string,
"unavailableReason": enum ( |
| Champs | |
|---|---|
id |
Uniquement en sortie. ID vidéo YouTube qui peut être recherché sur la page Web YouTube. |
unavailableReason |
Uniquement en sortie. Raison pour laquelle les données vidéo ne sont pas disponibles. |
videoAssetId |
Obligatoire. ID du composant vidéo YouTube. Il s'agit de l' |
VideoAspectRatio
Formats possibles pour une vidéo YouTube.
| Enums | |
|---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
Non spécifié ou inconnu. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
La vidéo est étirée, et les parties supérieure et inférieure sont recadrées. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
La vidéo utilise un format fixe de 16:9. |
InStreamAd
Informations sur une annonce InStream.
| Représentation JSON |
|---|
{
"commonInStreamAttribute": {
object ( |
| Champs | |
|---|---|
commonInStreamAttribute |
Obligatoire. Attributs d'annonce courants. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
CommonInStreamAttribute
Attributs courants pour les annonces InStream, non désactivables et bumper.
| Représentation JSON |
|---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
| Champs | |
|---|---|
displayUrl |
Obligatoire. Adresse de la page Web qui s'affiche avec l'annonce. |
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
actionButtonLabel |
Facultatif. Texte du bouton d'incitation à l'action. Doit être défini si |
actionHeadline |
Facultatif. Titre de la bannière d'incitation à l'action. |
video |
Obligatoire. Immuable. Vidéo YouTube de l'annonce. |
companionBanner |
Facultatif. Image qui s'affiche à côté de l'annonce vidéo. |
ImageAsset
Métadonnées d'un composant Image.
| Représentation JSON |
|---|
{
"mimeType": string,
"fullSize": {
object ( |
| Champs | |
|---|---|
mimeType |
Uniquement en sortie. Type MIME du composant Image. |
fullSize |
Uniquement en sortie. Métadonnées de cette image dans sa taille d'origine. |
fileSize |
Uniquement en sortie. Taille du fichier du composant Image, en octets. |
assetId |
Obligatoire. Identifiant unique de l'asset. |
NonSkippableAd
Informations sur une annonce non désactivable.
| Représentation JSON |
|---|
{
"commonInStreamAttribute": {
object ( |
| Champs | |
|---|---|
commonInStreamAttribute |
Obligatoire. Attributs d'annonce courants. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
BumperAd
Informations sur une annonce bumper.
| Représentation JSON |
|---|
{
"commonInStreamAttribute": {
object ( |
| Champs | |
|---|---|
commonInStreamAttribute |
Obligatoire. Attributs d'annonce courants. |
AudioAd
Informations sur une annonce audio.
| Représentation JSON |
|---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"userSpecifiedTrackingUrl": string,
"video": {
object ( |
| Champs | |
|---|---|
displayUrl |
Adresse de la page Web qui s'affiche avec l'annonce. |
finalUrl |
URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
trackingUrl |
URL chargée en arrière-plan à des fins de suivi. Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
video |
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 ( |
| Champs | |
|---|---|
headline |
Titre de l'annonce. |
description1 |
Première ligne de texte de l'annonce. |
description2 |
Deuxième ligne de texte de l'annonce. |
video |
Vidéo YouTube dont l'annonce fait la promotion. |
thumbnail |
Miniature utilisée dans l'annonce. |
Miniature
Options de miniatures possibles dans les annonces vidéo Discovery.
| Enums | |
|---|---|
THUMBNAIL_UNSPECIFIED |
Inconnu ou non spécifié. |
THUMBNAIL_DEFAULT |
Miniature par défaut, qui peut être générée automatiquement ou importée par l'utilisateur. |
THUMBNAIL_1 |
Miniature 1, générée à partir de la vidéo. |
THUMBNAIL_2 |
Miniature 2, générée à partir de la vidéo. |
THUMBNAIL_3 |
Miniature 3, générée à partir de la vidéo. |
VideoPerformanceAd
Informations sur une annonce vidéo axée sur les performances.
| Représentation JSON |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. Dans la version 4 et les versions antérieures, ce champ représente l'URL de suivi spécifiée manuellement par l'utilisateur. Vous le trouverez dans |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
actionButtonLabels[] |
Facultatif. Liste des composants Texte affichés sur le bouton d'incitation à l'action. Doit être défini si |
headlines[] |
Facultatif. Liste des titres affichés sur la bannière d'incitation à l'action. |
longHeadlines[] |
Facultatif. Liste des titres longs affichés sur la bannière d'incitation à l'action. Doit être défini, sauf si le champ |
descriptions[] |
Facultatif. Liste des descriptions affichées sur la bannière d'incitation à l'action. Doit être défini, sauf si le champ |
displayUrlBreadcrumb1 |
Facultatif. Première partie après le domaine dans l'URL à afficher. |
displayUrlBreadcrumb2 |
Facultatif. Deuxième partie après le domaine dans l'URL à afficher. Ne peut être défini que si |
domain |
Uniquement en sortie. Domaine de l'URL à afficher. |
videos[] |
Obligatoire. Liste des composants vidéo YouTube utilisés par cette annonce. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
companionBanners[] |
Facultatif. Liste des bannières associées utilisées par cette annonce. |
businessName |
Facultatif. Nom de l'établissement affiché dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
logo |
Facultatif. Image du logo utilisée par cette annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
DemandGenVideoAd
Détails d'une annonce vidéo Demand Gen.
| Représentation JSON |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": enum ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
callToAction |
Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce. Les valeurs acceptées sont les suivantes :
|
headlines[] |
Obligatoire. Liste des titres affichés dans l'annonce. |
longHeadlines[] |
Obligatoire. Liste des titres longs affichés dans l'annonce. |
descriptions[] |
Obligatoire. Liste des descriptions affichées dans l'annonce. |
displayUrlBreadcrumb1 |
Facultatif. Première partie après le domaine dans l'URL à afficher. |
displayUrlBreadcrumb2 |
Facultatif. Deuxième partie après le domaine dans l'URL à afficher. |
videos[] |
Obligatoire. Liste des composants vidéo YouTube utilisés par cette annonce. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
companionBanner |
Facultatif. Bannière associée utilisée par cette annonce. |
logo |
Facultatif. Image du logo utilisée par cette annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
finalMobileUrl |
Facultatif. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce sur un appareil mobile. |
finalUrlSuffix |
Facultatif. Suffixe à ajouter aux URL de page de destination. |
businessName |
Facultatif. Nom de l'établissement affiché dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
CallToAction
Valeurs d'incitation à l'action possibles pour les annonces vidéo/produit Demand Gen.
| Enums | |
|---|---|
CALL_TO_ACTION_UNSPECIFIED |
Non spécifié ou inconnu. |
AUTOMATED |
Automatisation. |
LEARN_MORE |
En savoir plus |
GET_QUOTE |
Obtenir un devis. |
APPLY_NOW |
Inscrivez-vous dès maintenant. |
SIGN_UP |
S'inscrire. |
CONTACT_US |
Contactez-nous. |
SUBSCRIBE |
S'abonner |
DOWNLOAD |
Télécharger. |
BOOK_NOW |
Réservez maintenant. |
SHOP_NOW |
Achetez-les dès maintenant. |
BUY_NOW |
Acheter. |
DONATE_NOW |
Faire un don |
ORDER_NOW |
Commandez maintenant. |
PLAY_NOW |
Jouez maintenant. |
SEE_MORE |
Voir plus. |
START_NOW |
Démarrez maintenant. |
VISIT_SITE |
Accéder au site. |
WATCH_NOW |
Regardez-les maintenant. |
DemandGenImageAd
Détails d'une annonce illustrée Demand Gen.
| Représentation JSON |
|---|
{ "finalUrl": string, "trackingUrl": string, "userSpecifiedTrackingUrl": string, "callToAction": string, "headlines": [ string ], "descriptions": [ string ], "customParameters": { string: string, ... }, "finalMobileUrl": string, "finalUrlSuffix": string, "businessName": string, "marketingImages": [ { object ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
callToAction |
Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce. |
headlines[] |
Obligatoire. Liste des titres affichés dans l'annonce. |
descriptions[] |
Obligatoire. Liste des descriptions affichées dans l'annonce. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
finalMobileUrl |
Facultatif. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce sur un appareil mobile. |
finalUrlSuffix |
Facultatif. Suffixe à ajouter aux URL de page de destination. |
businessName |
Facultatif. Nom de l'établissement affiché dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
marketingImages[] |
Liste des images marketing affichées dans l'annonce. |
squareMarketingImages[] |
Liste des images marketing carrées affichées dans l'annonce. |
portraitMarketingImages[] |
Liste des images marketing en mode portrait affichées dans l'annonce. |
logoImages[] |
Liste des images de logo affichées dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
DemandGenCarouselAd
Informations sur une annonce carrousel Demand Gen.
| Représentation JSON |
|---|
{ "finalUrl": string, "headline": string, "description": string, "cards": [ { object ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
headline |
Obligatoire. Titre de l'annonce. |
description |
Obligatoire. Description de l'annonce. |
cards[] |
Obligatoire. Liste des fiches affichées dans l'annonce. |
finalUrlSuffix |
Facultatif. Suffixe à ajouter aux URL de page de destination. |
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
businessName |
Facultatif. Nom de l'établissement affiché dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
logo |
Facultatif. Image du logo utilisée par cette annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
CarouselCard
Informations sur une fiche de carrousel Demand Gen.
| Représentation JSON |
|---|
{ "finalUrl": string, "finalMobileUrl": string, "headline": string, "callToAction": string, "marketingImage": { object ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur la fiche. |
finalMobileUrl |
Facultatif. URL de la page Web à laquelle les utilisateurs accèdent après avoir cliqué sur la fiche sur un appareil mobile. |
headline |
Obligatoire. Titre de la fiche. |
callToAction |
Obligatoire. Texte du bouton d'incitation à l'action affiché sur la fiche. Doit comporter 10 caractères maximum. |
marketingImage |
Facultatif. Image marketing affichée sur la fiche. |
squareMarketingImage |
Facultatif. Image marketing carrée affichée sur la fiche. |
portraitMarketingImage |
Facultatif. Image marketing en mode portrait affichée sur la fiche. |
DemandGenProductAd
Informations sur une annonce produit Demand Gen.
| Représentation JSON |
|---|
{ "finalUrl": string, "headline": string, "description": string, "finalUrlSuffix": string, "callToAction": enum ( |
| Champs | |
|---|---|
finalUrl |
Obligatoire. URL de la page Web à laquelle les internautes accèdent après avoir cliqué sur l'annonce. |
headline |
Obligatoire. Titre de l'annonce. |
description |
Obligatoire. Description de l'annonce. |
finalUrlSuffix |
Facultatif. Suffixe à ajouter aux URL de page de destination. |
callToAction |
Obligatoire. Bouton d'incitation à l'action affiché dans l'annonce. Les valeurs acceptées sont les suivantes :
|
trackingUrl |
Uniquement en sortie. URL chargée en arrière-plan à des fins de suivi. |
userSpecifiedTrackingUrl |
Facultatif. URL de suivi spécifiée manuellement par l'utilisateur. |
businessName |
Facultatif. Nom de l'établissement affiché dans l'annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
customParameters |
Facultatif. Paramètres personnalisés et valeurs associées à ajouter à l'URL de suivi. Objet contenant une liste de paires |
logo |
Facultatif. Image du logo utilisée par cette annonce. Ce paramètre est obligatoire, sauf si une valeur par défaut est définie au niveau de l'annonceur. Si vous ne définissez pas de valeur, la valeur par défaut sera appliquée. |
displayUrlBreadcrumb1 |
Facultatif. Première partie après le domaine dans l'URL à afficher. |
displayUrlBreadcrumb2 |
Facultatif. Deuxième élément après le domaine dans l'URL à afficher. |
AdPolicy
Règle relative aux annonces associée à une annonce de groupe d'annonces.
| Représentation JSON |
|---|
{ "adPolicyApprovalStatus": enum ( |
| Champs | |
|---|---|
adPolicyApprovalStatus |
État d'approbation d'une annonce, indiquant la décision d'approbation. |
adPolicyReviewStatus |
État de la vérification du respect des règles d'une annonce, indiquant l'étape actuelle du processus d'examen. |
adPolicyTopicEntry[] |
Entrées pour chaque thème de règle identifié comme étant lié à l'annonce. Chaque entrée inclut le thème, le niveau de restriction et des conseils pour résoudre les problèmes liés aux règles. |
AdPolicyApprovalStatus
États possibles d'une approbation des règles relatives aux annonces.
| Enums | |
|---|---|
AD_POLICY_APPROVAL_STATUS_UNKNOWN |
Inconnu ou non spécifié. |
DISAPPROVED |
Ne sera pas diffusé. |
APPROVED_LIMITED |
Sera diffusée avec des restrictions. |
APPROVED |
Sera diffusée sans restriction. |
AREA_OF_INTEREST_ONLY |
La diffusion n'aura pas lieu dans les pays ciblés, mais pourra avoir lieu pour les utilisateurs qui recherchent des informations sur les pays ciblés. |
AdPolicyReviewStatus
États possibles de la vérification du respect des règles relatives aux annonces.
| Enums | |
|---|---|
AD_POLICY_REVIEW_STATUS_UNKNOWN |
Inconnu ou non spécifié. |
REVIEW_IN_PROGRESS |
En cours d'examen. |
REVIEWED |
Examen principal terminé. D'autres examens peuvent être en cours. |
UNDER_APPEAL |
Renvoyé pour approbation ou une décision liée au règlement a fait l'objet d'un appel. |
ELIGIBLE_MAY_SERVE |
Jugée éligible et peut être diffusée. Un examen plus approfondi pourrait toujours avoir lieu. |
AdPolicyTopicEntry
Entrée décrivant comment une annonce a été identifiée comme étant liée à une règle relative aux annonces.
| Représentation JSON |
|---|
{ "policyTopic": string, "policyLabel": string, "policyTopicDescription": string, "policyTopicType": enum ( |
| Champs | |
|---|---|
policyTopic |
Thématique de la règle. Par exemple, "TRADEMARKS", "ALCOHOL", etc. |
policyLabel |
Texte du libellé localisé pour la règle. Par exemple, "Marques dans le texte", "Contient de l'alcool", etc. |
policyTopicDescription |
Brève description du thème de la règle. |
policyTopicType |
Comment la diffusion des annonces sera-t-elle affectée en raison de la relation avec le thème des règles relatives aux annonces ? |
policyDecisionType |
La source de la décision liée aux règles. |
policyEnforcementMeans |
Moyens d'application des règles utilisés lors de la vérification du respect des règles. |
policyTopicEvidences[] |
Preuve utilisée dans la décision liée aux règles. |
policyTopicConstraints[] |
Contraintes de diffusion pertinentes pour la décision liée aux règles. |
helpCenterLink |
Lien vers le centre d'aide sur les règles relatives aux annonces pour le thème de la règle. |
appealInfo |
Informations sur la procédure à suivre pour faire appel de la décision liée aux règles. |
AdPolicyTopicEntryType
Impacts possibles d'un thème des règles relatives aux annonces sur la diffusion.
| Enums | |
|---|---|
AD_POLICY_TOPIC_ENTRY_TYPE_UNKNOWN |
Inconnu ou non spécifié. |
PROHIBITED |
La ressource ne sera pas diffusée. |
FULLY_LIMITED |
La ressource ne sera pas diffusée dans tous les pays ciblés. |
LIMITED |
La ressource ne peut pas être diffusée dans certains pays. |
DESCRIPTIVE |
La ressource peut être diffusée. |
BROADENING |
La ressource peut être diffusée, et peut l'être au-delà de la couverture normale. |
AREA_OF_INTEREST_ONLY |
La ressource est limitée pour tous les pays ciblés, mais elle peut être diffusée auprès des utilisateurs qui recherchent des informations sur les pays ciblés. |
AdPolicyDecisionType
Sources possibles d'une décision liée aux règles.
| Enums | |
|---|---|
AD_POLICY_DECISION_TYPE_UNKNOWN |
Inconnu ou non spécifié. |
PURSUANT_TO_NOTICE |
La décision est basée sur une mention légale, une ordonnance du tribunal, une réclamation du propriétaire d'une marque, etc. |
GOOGLE_INVESTIGATION |
La décision est issue d'une enquête menée par Google. |
AdPolicyEnforcementMeans
Moyens possibles d'application des règles utilisés lors de la vérification du respect des règles.
| Enums | |
|---|---|
AD_POLICY_ENFORCEMENT_MEANS_UNKNOWN |
Inconnu ou non spécifié. |
AUTOMATED |
La procédure d'application était entièrement automatisée. |
HUMAN_REVIEW |
Un humain a été partiellement ou totalement impliqué dans le processus d'application de la décision. |
AdPolicyTopicEvidence
Informations sur les preuves utilisées dans la décision liée aux règles.
| Représentation JSON |
|---|
{ // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "textList": { object ( |
| Champs | |
|---|---|
| Preuve de la décision liée aux règles. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
textList |
Liste des preuves trouvées dans le texte de l'annonce. |
websiteList |
Liste des sites Web associés à l'annonce. |
httpCode |
Code HTTP renvoyé lors de l'exploration de l'URL finale. |
languageCode |
Langue dans laquelle l'annonce a été détectée. Ce champ utilise des tags de langue IETF, tels que "en-US". |
destinationTextList |
Texte de la destination de l'annonce qui entraîne un non-respect des règles. |
destinationMismatch |
Différence entre les URL de destination des annonces. |
destinationNotWorking |
Informations sur les erreurs HTTP ou DNS liées à la destination de l'annonce. |
trademark |
Termes de marque ayant entraîné un cas de non-respect des règles. |
legalRemoval |
Application d'une réglementation légale ayant entraîné un non-respect des règles. |
counterfeit |
Mesure d'application pour contrefaçon ayant entraîné un non-respect des règles. |
regionalRequirements |
Mesure d'application proactive de l'équipe Confiance et sécurité ayant entraîné un non-respect des règles. |
| Fin des champs mutuellement exclusifs. | |
TextList
Liste des fragments de texte qui ont enfreint la règle.
| Représentation JSON |
|---|
{ "texts": [ string ] } |
| Champs | |
|---|---|
texts[] |
Fragments de texte de la ressource qui ont déclenché le résultat de la règle. |
WebsiteList
Liste des sites Web qui ont enfreint la règle.
| Représentation JSON |
|---|
{ "websites": [ string ] } |
| Champs | |
|---|---|
websites[] |
Sites Web à l'origine du problème de non-respect des règles. |
DestinationTextList
Liste des textes de destination qui ont enfreint la règle.
| Représentation JSON |
|---|
{ "destinationTexts": [ string ] } |
| Champs | |
|---|---|
destinationTexts[] |
Texte de destination à l'origine du problème de non-respect des règles. |
DestinationMismatch
Détails sur une différence entre les types d'URL de destination.
| Représentation JSON |
|---|
{
"uriTypes": [
enum ( |
| Champs | |
|---|---|
uriTypes[] |
Ensemble d'URL qui ne correspondent pas. La liste peut inclure un ou plusieurs types d'URI. Exemple 1 : [ Exemple 2 : [ |
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 ( |
| Champs | |
|---|---|
expandedUri |
L'URL complète qui n'a pas fonctionné. |
device |
L'appareil sur lequel la visite de l'URL a entraîné l'erreur. |
lastCheckedTime |
Dernière fois que l'erreur a été détectée lors de l'accès à l'URL. Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : |
| Erreur HTTP ou DNS. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
dnsErrorType |
Type d'erreur DNS. |
httpErrorCode |
Code d'erreur HTTP. |
| Fin des champs mutuellement exclusifs. | |
AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType
Types d'erreurs DNS possibles.
| Enums | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DNS_ERROR_TYPE_UNKNOWN |
Non spécifié ou inconnu. |
HOSTNAME_NOT_FOUND |
Nom d'hôte introuvable dans le DNS lors de la récupération de la page de destination. |
GOOGLE_CRAWLER_DNS_ISSUE |
Google n'a pas pu explorer la page de destination lors de la communication avec le DNS. |
AdPolicyTopicEvidenceDestinationNotWorkingDeviceType
Appareils potentiels ayant rencontré une erreur lors de l'accès à l'URL.
| Enums | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN |
Non spécifié ou inconnu. |
DESKTOP |
Ordinateur de bureau. |
ANDROID |
Appareil Android. |
IOS |
appareil iOS. |
Marque
Termes de marque ayant entraîné un cas de non-respect des règles.
| Représentation JSON |
|---|
{
"owner": string,
"term": string,
"countryRestrictions": [
{
object ( |
| Champs | |
|---|---|
owner |
Le propriétaire de la marque. |
term |
Le nom de la marque. |
countryRestrictions[] |
Pays dans lesquels le non-respect des règles est pertinent. |
AdPolicyCriterionRestriction
Représente une restriction locale applicable.
| Représentation JSON |
|---|
{ "countryCriterionId": string, "countryLabel": string } |
| Champs | |
|---|---|
countryCriterionId |
ID du critère de pays. |
countryLabel |
Nom localisé du pays. Peut être vide. |
LegalRemoval
Application de réglementations juridiques, qu'elles soient issues du DMCA ou de réglementations locales.
| Représentation JSON |
|---|
{ "complaintType": enum ( |
| Champs | |
|---|---|
complaintType |
Type de réclamation à l'origine de la suppression pour motif légal. |
countryRestrictions[] |
Pays soumis à des restrictions en raison de la suppression pour motif légal. |
restrictedUris[] |
URL dont l'accès est limité en raison d'une suppression pour motif légal. |
| Détails sur le type de suppression pour motif légal. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
dmca |
Détails sur la suppression pour motif légal en vertu du DMCA. |
localLegal |
Détails sur la suppression pour motif légal liée à la réglementation locale. |
| Fin des champs mutuellement exclusifs. | |
DMCA
Détails de la réclamation DMCA.
| Représentation JSON |
|---|
{ "complainant": string } |
| Champs | |
|---|---|
complainant |
Entité qui a déposé la réclamation d'ordre juridique. |
LocalLegal
Informations sur les réglementations locales.
| Représentation JSON |
|---|
{ "lawType": string } |
| Champs | |
|---|---|
lawType |
Type de loi pour la mention légale. |
AdPolicyTopicEvidenceLegalRemovalComplaintType
Types de réclamations possibles pour une suppression pour motif légal.
| Enums | |
|---|---|
AD_POLICY_TOPIC_EVIDENCE_LEGAL_REMOVAL_COMPLAINT_TYPE_UNKNOWN |
Non spécifié ou inconnu. |
COPYRIGHT |
Droits d'auteur. S'applique uniquement au DMCA. |
COURT_ORDER |
Ordonnance du tribunal. S'applique uniquement aux mentions légales locales. |
LOCAL_LEGAL |
Réglementation juridique locale. S'applique uniquement aux mentions légales locales. |
Contrefaçon
Informations sur la mesure d'application concernant la contrefaçon qui a entraîné un cas de non-respect des règles.
| Représentation JSON |
|---|
{ "owners": [ string ] } |
| Champs | |
|---|---|
owners[] |
Les propriétaires du contenu ou du produit qui ont déposé une réclamation |
RegionalRequirements
Application proactive des règles par l'équipe Trust & Safety (T&S) pour répondre aux exigences régionales. Il s'agit d'une enquête menée par Google, et non d'un avis réglementaire, car il s'agit d'une application proactive des conditions d'utilisation.
| Représentation JSON |
|---|
{
"regionalRequirementsEntries": [
{
object ( |
| Champs | |
|---|---|
regionalRequirementsEntries[] |
Liste des exigences régionales. |
RegionalRequirementsEntry
Détails du non-respect des lois régionales au niveau des règles.
| Représentation JSON |
|---|
{
"legalPolicy": string,
"countryRestrictions": [
{
object ( |
| Champs | |
|---|---|
legalPolicy |
Le règlement juridique qui n'est pas respecté. |
countryRestrictions[] |
Pays soumis à des restrictions en raison du règlement juridique. |
AdPolicyTopicConstraint
Informations sur les contraintes de diffusion des annonces.
| Représentation JSON |
|---|
{ "requestCertificateFormLink": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "countryConstraint": { object ( |
| Champs | |
|---|---|
requestCertificateFormLink |
Lien vers le formulaire de demande de certificat pour la contrainte. |
| Contrainte de diffusion. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse : | |
countryConstraint |
Pays dans lesquels l'annonce ne peut pas être diffusée. |
resellerConstraint |
Contrainte de revendeur. |
certificateMissingCountryList |
Pays dans lesquels un certificat est requis pour la diffusion. |
certificateDomainMismatchCountryList |
Pays dans lesquels le domaine de la ressource n'est pas couvert par les certificats qui lui sont associés. |
globalCertificateMissing |
Un certificat est requis pour diffuser des annonces dans n'importe quel pays. |
globalCertificateDomainMismatch |
Un certificat est requis pour diffuser l'annonce dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce. |
| Fin des champs mutuellement exclusifs. | |
AdPolicyCountryConstraintList
Liste des pays dans lesquels l'annonce ne peut pas être diffusée en raison de contraintes liées aux règles.
| Représentation JSON |
|---|
{
"countries": [
{
object ( |
| Champs | |
|---|---|
countries[] |
Pays dans lesquels l'annonce ne peut pas être diffusée. |
AdPolicyResellerConstraint
Ce type ne comporte aucun champ.
Le thème de la règle a été limité, car le site Web a été refusé pour des raisons de revente.
AdPolicyGlobalCertificateMissingConstraint
Ce type ne comporte aucun champ.
Un certificat est requis pour diffuser des annonces dans n'importe quel pays.
AdPolicyGlobalCertificateDomainMismatchConstraint
Ce type ne comporte aucun champ.
Un certificat est requis pour diffuser l'annonce dans n'importe quel pays, et le certificat existant ne couvre pas le domaine de l'annonce.
AdPolicyTopicAppealInfo
Informations sur la procédure à suivre pour faire appel d'une décision liée aux règles.
| Représentation JSON |
|---|
{
"appealType": enum ( |
| Champs | |
|---|---|
appealType |
La possibilité ou non de faire appel via un appel en libre-service ou un formulaire d'appel. |
appealFormLink |
Disponible uniquement lorsque |
AdPolicyAppealType
Types d'appels possibles.
| Enums | |
|---|---|
AD_POLICY_APPEAL_TYPE_UNKNOWN |
Inconnu ou non spécifié. |
SELF_SERVICE_APPEAL |
Vous pouvez faire appel de la décision en libre-service. |
APPEAL_FORM |
Vous pouvez faire appel de la décision à l'aide d'un formulaire d'appel. |
AdUrl
URL supplémentaires liées à l'annonce, y compris les balises.
| Représentation JSON |
|---|
{
"type": enum ( |
| Champs | |
|---|---|
type |
Type de l'URL de l'annonce. |
url |
Valeur de la chaîne d'URL. |
AdUrlType
Types d'URL d'annonce possibles.
| Enums | |
|---|---|
AD_URL_TYPE_UNSPECIFIED |
Inconnu ou non spécifié. |
AD_URL_TYPE_BEACON_IMPRESSION |
Pixel de suivi 1x1 à pinger lorsqu'une impression d'une création est diffusée. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Balise d'impression DCM extensible. Au moment de la diffusion, il est développé en plusieurs balises. |
AD_URL_TYPE_BEACON_CLICK |
URL de suivi à pinger lorsque l'événement de clic est déclenché. |
AD_URL_TYPE_BEACON_SKIP |
URL de suivi à pinguer lorsque l'événement d'abandon est déclenché. |
DcmTrackingInfo
Détails sur le suivi DCM.
| Représentation JSON |
|---|
{ "placementId": string, "trackingAdId": string, "creativeId": string } |
| Champs | |
|---|---|
placementId |
Obligatoire. ID d'emplacement DCM. |
trackingAdId |
Obligatoire. ID de l'annonce de suivi DCM. |
creativeId |
Obligatoire. ID de la création DCM. |
Méthodes |
|
|---|---|
|
Crée une annonce de groupe d'annonces. |
|
Supprime une annonce de groupe d'annonces. |
|
Récupère une annonce de groupe d'annonces. |
|
Répertorie les annonces du groupe d'annonces. |
|
Met à jour une annonce de groupe d'annonces. |