Ads Data Hub API

API permettant d'exécuter des requêtes Ads Data Hub

Service: adsdatahub.googleapis.com

Pour appeler ce service, nous vous recommandons d'utiliser les bibliothèques clientes fournies par Google. Si votre application doit utiliser vos propres bibliothèques pour appeler ce service, utilisez les informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification exploitable par un ordinateur qui permet de décrire et de consommer les API REST. Ce document permet de créer des bibliothèques clientes, des plug-ins IDE et d'autres outils qui interagissent avec les API Google. Un même service peut fournir plusieurs documents de découverte. Ce service fournit le document de découverte suivant :

Point de terminaison de service

Un point de terminaison de service est une URL de base qui spécifie l'adresse réseau d'un service d'API. Un service peut avoir plusieurs points de terminaison de service. Ce service possède le point de terminaison de service suivant, et tous les URI ci-dessous sont relatifs à ce point de terminaison de service :

  • https://adsdatahub.googleapis.com

Ressource REST : v1.customers

Méthodes
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Décrit les références annonceur DV360 valides
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Répertorie les correspondances d'événements valides, ainsi que leurs métadonnées pour les listes d'audience liées à la limitation de la fréquence d'exposition.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Exporte l'historique des tâches d'un compte client vers l'ensemble de données BigQuery sélectionné par le client.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Démarre l'exécution d'une requête pour récupérer les métriques de visibilité du trafic incorrect pour la plate-forme DV360.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Démarre l'exécution d'une requête pour récupérer un récapitulatif quotidien du nombre de trafic incorrect pour une plate-forme spécifique.
get GET /v1/{name=customers/*}
Récupère le client Ads Data Hub demandé.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Renvoie le pourcentage de données Google pour tous les clients qui ont bien été ingérés dans ADH à la date donnée.
list GET /v1/customers
Répertorie les clients Ads Data Hub auxquels l'utilisateur actuel a accès.

Ressource REST: v1.customers.adsDataCustomers

Méthodes
get GET /v1/{name=customers/*/adsDataCustomers/*}
Récupère le client Ads Data Hub demandé.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Récupère le budget d'accès aux données pour la source de données Ads demandée pour les 366 derniers jours.
list GET /v1/{parent=customers/*}/adsDataCustomers
Répertorie les données sur les annonces auxquelles les clients ont accès.

Ressource REST: v1.customers.analysisqueries

Méthodes
create POST /v1/{parent=customers/*}/analysisQueries
Crée une requête d'analyse pour une exécution ultérieure.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Supprime une requête d'analyse.
get GET /v1/{name=customers/*/analysisQueries/*}
Récupère la requête d'analyse demandée.
list GET /v1/{parent=customers/*}/analysisQueries
Répertorie les requêtes d'analyse appartenant au client spécifié.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Met à jour une requête d'analyse existante.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Démarre l'exécution sur une requête d'analyse stockée.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Démarre l'exécution sur une requête d'analyse temporaire.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Effectue des contrôles de validation statique sur la requête d'analyse fournie.

Ressource REST : v1.customers.customBiddingAlgorithms

Méthodes
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Ajoutez un annonceur DV360 aux annonceurs utilisant l'algorithme d'enchères personnalisées.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Crée un algorithme d'enchères personnalisées géré par Ads Data Hub.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Supprimez cet algorithme d'enchères personnalisées.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Indique les 30 derniers jours d'impressions pour les modèles d'enchères personnalisées.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Récupère l'algorithme d'enchères personnalisées géré par Ads Data Hub qui est demandé.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Répertorie les algorithmes d'enchères personnalisées gérés par le client Ads Data Hub spécifié.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Met à jour l'algorithme d'enchères personnalisées géré par Ads Data Hub qui est demandé.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Supprimez un annonceur DV360 de la liste des annonceurs utilisant l'algorithme d'enchères personnalisées.

Ressource REST: v1.customers.tables

Méthodes
get GET /v1/{name=customers/*/tables/*}
Récupère le tableau Ads Data Hub demandé.
list GET /v1/{parent=customers/*}/tables
Répertorie les tables Ads Data Hub auxquelles le client spécifié a accès.

Ressource REST: v1.customers.tempTables

Méthodes
get GET /v1/{name=customers/*/tempTables/*}
Récupère le tableau temporaire Ads Data Hub demandé.
list GET /v1/{parent=customers/*}/tempTables
Répertorie les tables temporaires Ads Data Hub que le client a créées.

Ressource REST: v1.customers.userListQuery

Méthodes
create POST /v1/{parent=customers/*}/userListQueries
Crée une requête de liste d'utilisateurs pour une exécution ultérieure.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Supprime une requête de liste d'utilisateurs.
get GET /v1/{name=customers/*/userListQueries/*}
Récupère la requête de liste d'utilisateurs demandée.
list GET /v1/{parent=customers/*}/userListQueries
Répertorie les requêtes de liste d'utilisateurs appartenant au client spécifié.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Met à jour une requête de liste d'utilisateurs existante.
start POST /v1/{name=customers/*/userListQueries/*}:start
Démarre l'exécution d'une requête de liste d'utilisateurs stockée.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Démarre l'exécution sur une requête temporaire de liste d'utilisateurs.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Effectue des contrôles de validation statique sur la requête de liste d'utilisateurs fournie.

Ressource REST: v1.customers.userLists

Méthodes
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Ajoute des outils de mise en correspondance des événements à une liste d'utilisateurs basée sur la fréquence.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Ajoutez des entités aux destinataires d'une liste d'utilisateurs gérée par Ads Data Hub.
create POST /v1/{parent=customers/*}/userLists
Crée une liste d'utilisateurs gérée par Ads Data Hub.
delete DELETE /v1/{name=customers/*/userLists/*}
Supprimez la liste d'utilisateurs gérée par Ads Data Hub demandée.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Génère des adhésions pour la liste d'utilisateurs.
get GET /v1/{name=customers/*/userLists/*}
Récupère la liste des utilisateurs gérés par Ads Data Hub demandée.
list GET /v1/{parent=customers/*}/userLists
Répertorie les listes d'utilisateurs gérées par le client Ads Data Hub spécifié.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Met à jour la liste d'utilisateurs gérée par Ads Data Hub demandée.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Supprime les entités des destinataires d'une liste d'utilisateurs gérée par Ads Data Hub.

Ressource REST : v1.operations

Méthodes
cancel POST /v1/{name=operations/**}:cancel
Démarre l'annulation asynchrone sur une opération de longue durée.
delete DELETE /v1/{name=operations/**}
Supprime une opération de longue durée.
get GET /v1/{name=operations/**}
Récupère le dernier état d'une opération de longue durée.
list GET /v1/{name}
Répertorie les opérations qui correspondent au filtre spécifié dans la requête.
wait POST /v1/{name=operations/**}:wait
Attend que l'opération de longue durée spécifiée soit terminée ou qu'elle atteigne le délai avant expiration spécifié, renvoyant le dernier état.

Ressource REST: v1.outages

Méthodes
list GET /v1/outages
Répertorie les interruptions par ordre décroissant d'horodatage de début. La période d'analyse est de 130 jours.