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)
    }
  ],

  // 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)
  }
  // End of list of possible types for union field ad_details.
}
Champs
name

string

Nom de ressource de l'annonce.
advertiserId

string (int64 format)

Identifiant unique de l'annonceur auquel appartient l'annonce.
adGroupAdId

string (int64 format)

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

string (int64 format)

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

string

Nom à afficher de l'annonce.

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

object (AdPolicy)

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

enum (EntityStatus)

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

object (AdUrl)

Liste des URL utilisées par l'annonce.

Champ d'union ad_details. Détails de l'annonce.

La ad_details ne peut être qu'un des éléments suivants :
displayVideoSourceAd

object (DisplayVideoSourceAd)

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

object (MastheadAd)

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

object (InStreamAd)

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)

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)

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)

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

object (VideoDiscoveryAd)

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

object (VideoPerformanceAd)

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.

AdPolicy

Règlement sur les annonces associé à une annonce de groupe d'annonces.

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

enum (AdPolicyApprovalStatus)

État d'approbation 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 se rapportant à 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 de la règle.

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 concernant le règlement.
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 a été prise à l'issue 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 preuves trouvées dans le texte de l'annonce.
websiteList

object (WebsiteList)

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

integer

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

string

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

Ce champ utilise des 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)

Mesure appliquée pour 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é une violation 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 de la constatation de 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 à l'origine de la constatation de non-respect des règles.

DestinationMismatch

Détails sur une incohé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 avec la 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 n'a pas fonctionné.
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 restreint en raison de la suppression légale
restrictedUris[]

string

URL restreintes 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

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

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

string

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

RegionalRequirements

Application proactive 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 détaillées 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.

Le thème lié aux règles a été limité, car le site Web a été refusé à des fins de revente.

AdPolicyGlobalCertificateMissingConstraint

Ce type ne comporte aucun champ.

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

AdPolicyGlobalCertificateDomainMismatchConstraint

Ce type ne comporte aucun champ.

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

AdPolicyTopicAppealInfo

Informations sur la façon de faire appel d'une décision liée aux règles.

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

enum (AdPolicyAppealType)

Si vous pouvez faire appel de la décision en libre-service ou à l'aide d'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)
}
Champs
id

string

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.

VideoUnavailableReason

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

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

VideoAspectRatio

Formats possibles pour une vidéo YouTube.

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

InStreamAd

Informations sur une annonce InStream.

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

object (CommonInStreamAttribute)

Attributs d'annonce courants.
customParameters

map (key: string, value: string)

Paramètres personnalisés permettant de transmettre des valeurs personnalisées au modèle d'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 internautes 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
}
Champs
mimeType

string

Type MIME du composant Image.
fullSize

object (Dimensions)

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

string (int64 format)

Taille du fichier de l'image en octets.

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 permettant de transmettre des valeurs personnalisées au modèle d'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 internautes 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 La miniature par défaut peut être générée automatiquement ou importée par l'utilisateur.
THUMBNAIL_1 Miniature 1, générée à partir de la vidéo.
THUMBNAIL_2 Miniature 2, générée à partir de la vidéo.
THUMBNAIL_3 Miniature 3, générée à partir de la vidéo.

VideoPerformanceAd

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 internautes 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 seuls affichés sur la bannière d'incitation à l'action.
descriptions[]

string

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

string

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

string

Il s'agit 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 permettant de transmettre des valeurs personnalisées au modèle d'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.

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 développé en plusieurs balises.
AD_URL_TYPE_BEACON_CLICK URL de suivi à envoyer lorsque l'événement de clic est déclenché.
AD_URL_TYPE_BEACON_SKIP URL de suivi à pinguer lorsque l'événement de désactivation est déclenché.

Méthodes

get

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

list

 Liste les annonces du groupe d'annonces.