REST Resource: advertisers.adGroupAds

Ressource : AdGroupAd

Une seule annonce associée à un groupe d'annonces.

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

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

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

Obligatoire. Nom à afficher de l'annonce.

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

object (AdPolicy)

Uniquement en sortie. État d'approbation de l'annonce au regard du règlement.
entityStatus

enum (EntityStatus)

Obligatoire. État de l'entité de l'annonce.
adUrls[]

object (AdUrl)

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

object (DcmTrackingInfo)

Facultatif. Informations sur l'annonce de suivi DCM. Valable uniquement pour les annonces de génération de la demande.

Pour supprimer les informations sur l'annonce de suivi DCM, veuillez laisser ce champ vide.
Champ d'union ad_details. Détails de l'annonce. ad_details ne peut être qu'un des éléments suivants :
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

Uniquement en sortie. Détails d'une annonce InStream désactivable au bout de cinq secondes, utilisée pour les objectifs marketing de notoriété de la marque ou de couverture.
nonSkippableAd

object (NonSkippableAd)

Uniquement en sortie. Détails d'une annonce vidéo InStream courte non désactivable, d'une durée comprise entre 6 et 15 secondes, utilisée pour les objectifs marketing de couverture.
bumperAd

object (BumperAd)

Uniquement en sortie. Détails d'une annonce vidéo courte non désactivable, d'une durée maximale de six secondes, utilisée pour la couverture.
audioAd

object (AudioAd)

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

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

Uniquement en sortie. Détails d'une annonce utilisée dans une campagne vidéo pour l'action afin d'inciter les utilisateurs à agir concernant l'entreprise, le service ou le produit.
demandGenVideoAd

object (DemandGenVideoAd)

Détails d'une annonce vidéo de génération de la demande.
demandGenImageAd

object (DemandGenImageAd)

Détails d'une annonce illustrée de génération de la demande.
demandGenProductAd

object (DemandGenProductAd)

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

AdPolicy

Règlement relatif à une seule annonce associé à une annonce de groupe d'annonces.

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

enum (AdPolicyApprovalStatus)

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

enum (AdPolicyReviewStatus)

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

object (AdPolicyTopicEntry)

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

AdPolicyApprovalStatus

États possibles de l'approbation d'une annonce

Enums
AD_POLICY_APPROVAL_STATUS_UNKNOWN Inconnu ou non spécifié.
DISAPPROVED Ne sera pas diffusé.
APPROVED_LIMITED Sera diffusé avec des restrictions.
APPROVED Sera diffusée sans restriction.
AREA_OF_INTEREST_ONLY Ne sera pas diffusée dans les pays ciblés, mais pourra l'être auprès des utilisateurs qui recherchent des informations sur ces pays.

AdPolicyReviewStatus

États possibles de l'examen du respect des règles relatives aux annonces.

Enums
AD_POLICY_REVIEW_STATUS_UNKNOWN Inconnu ou non spécifié.
REVIEW_IN_PROGRESS En cours d'examen.
REVIEWED L'examen principal est terminé. D'autres examens peuvent être en cours.
UNDER_APPEAL La création a été renvoyée pour approbation ou une décision liée au règlement a fait l'objet d'un appel.
ELIGIBLE_MAY_SERVE Éligible et peut être en cours de diffusion. Un examen plus approfondi peut encore avoir lieu.

AdPolicyTopicEntry

Entrée décrivant comment une annonce a été identifiée comme étant liée à un règlement publicitaire.

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

string

Thème des règles.

Exemples : "MARQUES DÉPOSÉES", "ALCOOL", etc.
policyLabel

string

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

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

string

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

enum (AdPolicyTopicEntryType)

Comment la diffusion d'annonces sera affectée en raison de la relation avec le thème des règles relatives aux annonces.
policyDecisionType

enum (AdPolicyDecisionType)

Source de la décision liée au règlement.
policyEnforcementMeans

enum (AdPolicyEnforcementMeans)

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

object (AdPolicyTopicEvidence)

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

object (AdPolicyTopicConstraint)

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

object (AdPolicyTopicAppealInfo)

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

AdPolicyTopicEntryType

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

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

AdPolicyDecisionType

Sources possibles d'une décision concernant le règlement.

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

AdPolicyEnforcementMeans

Moyens possibles d'application des règles utilisés lors de l'examen 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 concernant le règlement.

Représentation JSON 
{

  // Union field value can be only one of the following:
  "textList": {
    object (TextList)
  },
  "websiteList": {
    object (WebsiteList)
  },
  "httpCode": integer,
  "languageCode": string,
  "destinationTextList": {
    object (DestinationTextList)
  },
  "destinationMismatch": {
    object (DestinationMismatch)
  },
  "destinationNotWorking": {
    object (DestinationNotWorking)
  },
  "trademark": {
    object (Trademark)
  },
  "legalRemoval": {
    object (LegalRemoval)
  },
  "counterfeit": {
    object (Counterfeit)
  },
  "regionalRequirements": {
    object (RegionalRequirements)
  }
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. Preuve de la décision liée au règlement. value ne peut être qu'un des éléments suivants :
textList

object (TextList)

Liste des éléments de preuve trouvés dans le texte de l'annonce.
websiteList

object (WebsiteList)

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

integer

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

string

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

Ce champ utilise des balises de langue IETF, telles que "en-US".
destinationTextList

object (DestinationTextList)

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

object (DestinationMismatch)

Une incohérence entre les URL de destination des annonces.
destinationNotWorking

object (DestinationNotWorking)

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

object (Trademark)

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

object (LegalRemoval)

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

object (Counterfeit)

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

object (RegionalRequirements)

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

TextList

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

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

string

Fragments de texte de la ressource à l'origine du non-respect des règles.

WebsiteList

Une liste des sites Web qui ont enfreint le règlement.

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

string

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

DestinationTextList

Liste du texte de destination qui ne respecte pas le règlement.

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

string

Texte de la destination ayant entraîné le non-respect des règles.

DestinationMismatch

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

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

enum (AdPolicyTopicEvidenceDestinationMismatchUrlType)

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

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

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

AdPolicyTopicEvidenceDestinationMismatchUrlType

Types d'URL possibles.

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

DestinationNotWorking

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

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

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

string

L'URL complète qui ne fonctionne pas.
device

enum (AdPolicyTopicEvidenceDestinationNotWorkingDeviceType)

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

string (Timestamp format)

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

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
Champ d'union reason. Erreur HTTP ou DNS. reason ne peut être qu'un des éléments suivants :
dnsErrorType

enum (AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType)

Type d'erreur DNS.
httpErrorCode

string (int64 format)

Code d'erreur HTTP.

AdPolicyTopicEvidenceDestinationNotWorkingDnsErrorType

Types d'erreurs DNS possibles.

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

AdPolicyTopicEvidenceDestinationNotWorkingDeviceType

Appareils susceptibles d'avoir rencontré une erreur lors de l'accès à l'URL.

Enums
AD_POLICY_TOPIC_EVIDENCE_DESTINATION_NOT_WORKING_DEVICE_TYPE_UNKNOWN Non spécifié ou inconnu.
DESKTOP Ordinateur
ANDROID Un appareil Android.
IOS un appareil iOS.

Marque

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

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

string

Propriétaire du contenu de la marque.
term

string

Terme enregistré en tant que marque.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

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

AdPolicyCriterionRestriction

Représente une restriction de pays.

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

string (int64 format)

ID du critère de pays.
countryLabel

string

Nom localisé du pays. Peut être vide.

LegalRemoval

Application des réglementations juridiques, qu'elles soient liées au DMCA ou à la législation locale.

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

  // Union field type can be only one of the following:
  "dmca": {
    object (Dmca)
  },
  "localLegal": {
    object (LocalLegal)
  }
  // End of list of possible types for union field type.
}
Champs
complaintType

enum (AdPolicyTopicEvidenceLegalRemovalComplaintType)

Type de réclamation ayant entraîné la suppression légale.
countryRestrictions[]

object (AdPolicyCriterionRestriction)

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

string

URL limitées en raison de la suppression légale.
Champ d'union type. Détails sur le type de suppression pour motifs juridiques. type ne peut être qu'un des éléments suivants :
dmca

object (Dmca)

Détails sur la suppression pour motifs juridiques en vertu de la loi DMCA.

DMCA

Informations sur la réclamation DMCA.

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

string

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

LocalLegal

Informations sur les réglementations juridiques locales.

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

string

Type de loi pour les mentions légales.

AdPolicyTopicEvidenceLegalRemovalComplaintType

Types de réclamations possibles pour une suppression légale.

Enums
COPYRIGHT

Droits d'auteur.

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

Ordonnance du tribunal.

Ne s'applique qu'aux lois locales.

Contrefaçon

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

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

string

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

RegionalRequirements

Application proactive des règles de confiance et sécurité (T&S) destinées à répondre aux exigences régionales. Il s'agit d'une enquête appartenant à Google et non d'une notification de réglementation, car il s'agit d'une application proactive des conditions d'utilisation.

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

object (RegionalRequirementsEntry)

Liste des exigences régionales.

RegionalRequirementsEntry

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

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

string

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

object (AdPolicyCriterionRestriction)

Pays dont l'accès est limité en raison des règles juridiques.

AdPolicyTopicConstraint

Informations sur les contraintes de diffusion d'annonces.

Représentation JSON 
{
  "requestCertificateFormLink": string,

  // Union field constraint can be only one of the following:
  "countryConstraint": {
    object (AdPolicyCountryConstraintList)
  },
  "resellerConstraint": {
    object (AdPolicyResellerConstraint)
  },
  "certificateMissingCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "certificateDomainMismatchCountryList": {
    object (AdPolicyCountryConstraintList)
  },
  "globalCertificateMissing": {
    object (AdPolicyGlobalCertificateMissingConstraint)
  },
  "globalCertificateDomainMismatch": {
    object (AdPolicyGlobalCertificateDomainMismatchConstraint)
  }
  // End of list of possible types for union field constraint.
}
Champs
Champ d'union constraint. Contrainte de diffusion. constraint ne peut être qu'un des éléments suivants :
countryConstraint

object (AdPolicyCountryConstraintList)

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

object (AdPolicyResellerConstraint)

Contrainte de revendeur.
certificateMissingCountryList

object (AdPolicyCountryConstraintList)

Pays dans lesquels un certificat est requis pour la diffusion.
certificateDomainMismatchCountryList

object (AdPolicyCountryConstraintList)

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

object (AdPolicyGlobalCertificateMissingConstraint)

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

object (AdPolicyGlobalCertificateDomainMismatchConstraint)

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

AdPolicyCountryConstraintList

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

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

object (AdPolicyCriterionRestriction)

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

AdPolicyResellerConstraint

Ce type ne comporte aucun champ.

La section sur les règles a été limitée, car le site Web a été refusé à des fins de revente.

AdPolicyGlobalCertificateMissingConstraint

Ce type ne comporte aucun champ.

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

AdPolicyGlobalCertificateDomainMismatchConstraint

Ce type ne comporte aucun champ.

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

AdPolicyTopicAppealInfo

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

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

enum (AdPolicyAppealType)

Indique si la décision peut faire l'objet d'un appel en libre-service ou via un formulaire d'appel.

AdPolicyAppealType

Types d'appels possibles.

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

DisplayVideoSourceAd

Annonce provenant d'une création DV360.

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

string (int64 format)

ID de la création source.

MastheadAd

Informations sur une bannière Masthead.

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

object (YoutubeVideoDetails)

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

string

Titre de l'annonce.
description

string

Description de l'annonce.
videoAspectRatio

enum (VideoAspectRatio)

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

string (int64 format)

Durée en millisecondes après laquelle la vidéo commence à être lue.
autoplayVideoDuration

string (Duration format)

Durée pendant laquelle la vidéo sera lue automatiquement.

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

string

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

string

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

string

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

boolean

Indique si un arrière-plan ou une bannière doit s'afficher en haut d'une page YouTube.
companionYoutubeVideos[]

object (YoutubeVideoDetails)

Vidéos s'affichant à côté de la bannière Masthead sur ordinateur. Vous ne pouvez pas en ajouter plus de deux.

YoutubeVideoDetails

Informations sur une vidéo YouTube.

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

string

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

enum (VideoUnavailableReason)

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

string (int64 format)

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

VideoUnavailableReason

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

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

VideoAspectRatio

Formats possibles pour une vidéo YouTube.

Enums
VIDEO_ASPECT_RATIO_UNSPECIFIED Non spécifié ou inconnu.
VIDEO_ASPECT_RATIO_WIDESCREEN La vidéo est étirée et le haut et le bas sont rognés.
VIDEO_ASPECT_RATIO_FIXED_16_9 La vidéo utilise un format 16:9 fixe.

InStreamAd

Informations sur une annonce InStream.

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

object (CommonInStreamAttribute)

Attributs d'annonce courants.
customParameters

map (key: string, value: string)

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

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

CommonInStreamAttribute

Attributs communs aux annonces InStream, non désactivables et bumper.

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

string

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

string

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

Vidéo YouTube de l'annonce.
companionBanner

object (ImageAsset)

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

ImageAsset

Métadonnées d'un composant Image.

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

string

Uniquement en sortie. Type MIME du composant Image.
fullSize

object (Dimensions)

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

string (int64 format)

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

string (int64 format)

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

NonSkippableAd

Informations sur une annonce non désactivable.

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

object (CommonInStreamAttribute)

Attributs d'annonce courants.
customParameters

map (key: string, value: string)

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

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

BumperAd

Informations sur une annonce bumper.

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

object (CommonInStreamAttribute)

Attributs d'annonce courants.

AudioAd

Informations sur une annonce audio.

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

string

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

string

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

string

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

object (YoutubeVideoDetails)

Vidéo YouTube de l'annonce.

VideoDiscoveryAd

Détails d'une annonce vidéo Discovery.

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

string

Titre de l'annonce.
description1

string

Première ligne de texte de l'annonce.
description2

string

Deuxième ligne de texte de l'annonce.
video

object (YoutubeVideoDetails)

Vidéo YouTube promue par l'annonce.
thumbnail

enum (Thumbnail)

Image 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

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

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

string

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

string

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

string

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

string

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

string

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

string

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

string

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

string

Il s'agit de la deuxième partie de l'URL à afficher après le domaine.
domain

string

Domaine de l'URL à afficher.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

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

DemandGenVideoAd

Informations sur une annonce vidéo de génération de la demande.

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

string

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

string

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

string

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

enum (CallToAction)

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

Les valeurs acceptées sont les suivantes :

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

string

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

string

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

string

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

string

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

string

Facultatif. Il s'agit de la deuxième partie de l'URL à afficher après le domaine.
videos[]

object (YoutubeVideoDetails)

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

map (key: string, value: string)

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

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

object (ImageAsset)

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

string

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

string

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

string

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

CallToAction

Valeurs possibles pour l'incitation à l'action des annonces produit/vidéo de génération de la demande.

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

DemandGenImageAd

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

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

string

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

string

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

string

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

string

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

string

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

string

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

map (key: string, value: string)

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

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

string

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

string

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

string

Obligatoire. Nom de l'établissement affiché dans l'annonce.
marketingImages[]

object (ImageAsset)

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

object (ImageAsset)

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

object (ImageAsset)

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

object (ImageAsset)

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

DemandGenCarouselAd

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

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

string

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

string

Obligatoire. Titre de l'annonce.
description

string

Obligatoire. Description de l'annonce.
cards[]

object (CarouselCard)

Obligatoire. Liste des cartes affichées dans l'annonce.
finalUrlSuffix

string

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

string

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

string

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

string

Obligatoire. Nom de l'établissement affiché dans l'annonce.
customParameters

map (key: string, value: string)

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

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

CarouselCard

Informations sur une fiche de carrousel de génération de la demande.

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

string

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

string

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

string

Obligatoire. Titre de la fiche.
callToAction

string

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

Doit comporter 10 caractères maximum.
marketingImage

object (ImageAsset)

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

object (ImageAsset)

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

object (ImageAsset)

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

DemandGenProductAd

Informations détaillées sur une annonce produit de génération de la demande.

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

string

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

string

Obligatoire. Titre de l'annonce.
description

string

Obligatoire. Description de l'annonce.
finalUrlSuffix

string

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

enum (CallToAction)

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

Les valeurs acceptées sont les suivantes :

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

string

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

string

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

string

Obligatoire. Nom de l'établissement affiché dans l'annonce.
customParameters

map (key: string, value: string)

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

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

string

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

string

Facultatif. Il s'agit de la deuxième partie de l'URL à afficher après le domaine.

AdUrl

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

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

enum (AdUrlType)

Type d'URL de l'annonce.
url

string

Valeur de la chaîne URL.

AdUrlType

Types d'URL d'annonce possibles.

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

DcmTrackingInfo

Détails sur le suivi DCM.

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

string (int64 format)

Obligatoire. ID d'emplacement DCM.
trackingAdId

string (int64 format)

Obligatoire. ID de l'annonce de suivi DCM.
creativeId

string (int64 format)

Obligatoire. ID de la création DCM.

Méthodes

create

 Crée une annonce de groupe d'annonces.

delete

 Supprime une annonce de groupe d'annonces.

get

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

list

 Liste les annonces du groupe d'annonces.

patch

 Met à jour une annonce de groupe d'annonces.