Method: advertisers.audit

L'

Audite un annonceur. Renvoie le nombre d'entités utilisées par type de ressource pour l'annonceur fourni. Les entités utilisées sont comptabilisées dans leur limite de ressources respective. Consultez https://support.google.com/displayvideo/answer/6071450.

Requête HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}:audit

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
advertiserId

string (int64 format)

Obligatoire. ID de l'annonceur à auditer.

Paramètres de requête

Paramètres
readMask

string (FieldMask format)

Facultatif. Champs spécifiques à renvoyer. Si aucun masque n'est spécifié, tous les champs du proto de réponse seront renseignés. Les valeurs valides sont les suivantes :

  • usedLineItemsCount
  • usedInsertionOrdersCount
  • usedCampaignsCount
  • channelsCount
  • negativelyTargetedChannelsCount
  • negativeKeywordListsCount
  • adGroupCriteriaCount
  • campaignCriteriaCount

Il s'agit d'une liste de noms de champs complets séparés par une virgule. Exemple : "user.displayName,photo"

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour AdvertiserService.AuditAdvertiser.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "usedLineItemsCount": string,
  "usedInsertionOrdersCount": string,
  "usedCampaignsCount": string,
  "channelsCount": string,
  "negativelyTargetedChannelsCount": string,
  "negativeKeywordListsCount": string,
  "adGroupCriteriaCount": string,
  "campaignCriteriaCount": string
}
Champs
usedLineItemsCount

string (int64 format)

Nombre d'éléments de campagne actifs, mis en veille et en brouillon pour cet annonceur. Ces éléments de campagne sont pris en compte dans la limite de 9 999 éléments de campagne par annonceur.
usedInsertionOrdersCount

string (int64 format)

Nombre d'ordres d'insertion ACTIFS, MIS EN VEILLE et EN BROUILLON pour cet annonceur. Ces ordres d'insertion sont comptabilisés dans la limite de 9 999 ordres d'insertion par annonceur.
usedCampaignsCount

string (int64 format)

Nombre de campagnes ACTIVES et EN PAUSE pour cet annonceur. Ces campagnes sont prises en compte dans la limite de 9 999 campagnes par annonceur.
channelsCount

string (int64 format)

Nombre de chaînes créées pour cet annonceur. Ces chaînes sont comptabilisées dans la limite de 1 000 chaînes par annonceur.
negativelyTargetedChannelsCount

string (int64 format)

Nombre de chaînes ciblées de manière négative pour cet annonceur. Ces chaînes ciblées de manière négative sont comptabilisées dans la limite de cinq chaînes ciblées de manière négative par annonceur.
negativeKeywordListsCount

string (int64 format)

Nombre de listes de mots clés à exclure créées pour cet annonceur. Ces listes de mots clés à exclure sont incluses dans la limite de 20 listes de mots clés à exclure par annonceur.
adGroupCriteriaCount

string (int64 format)

Nombre d'options de ciblage spécifiques issues des types de ciblage suivants qui sont attribuées à un élément de campagne de cet annonceur. Ces options de ciblage individuelles sont comptabilisées dans la limite de 4 500 000 options de ciblage par groupe d'annonces et par annonceur.

Types de ciblage éligibles :

  • Catégories, URL, applications et collections
  • Catégorie démographique
  • Audiences Google, y compris les audiences d'affinité, d'affinité personnalisée et sur le marché
  • Source d'inventaire
  • Mot clé
  • Catégorie d'application mobile
  • Listes d'utilisateurs
  • Ciblage vidéo
  • Visibilité
campaignCriteriaCount

string (int64 format)

Nombre d'options de ciblage spécifiques issues des types de ciblage suivants qui sont attribuées à un élément de campagne de cet annonceur. Ces options de ciblage individuelles sont comptabilisées dans la limite de 900 000 options de ciblage de campagne par annonceur.

Types de ciblage éligibles :

  • Position
  • Navigateur
  • Vitesse de connexion
  • Jour et heure
  • L'appareil et le système d'exploitation
  • Libellé de contenu numérique
  • Catégories sensibles
  • Environnement
  • Zone géographique, y compris les chaînes d'établissement et les zones de proximité
  • FAI
  • Langue
  • Validation tierce

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/display-video

Pour plus d'informations, consultez la OAuth 2.0 Overview.