Curation Partners API

L'API Curation Partners est une API HTTP disponible en externe qui permet aux curateurs de gérer de manière programmatique leurs segments de données et les packages sélectionnés utilisés par les agences publicitaires.

Service : curationpartners.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, conformez-vous aux informations suivantes lorsque vous effectuez les requêtes API.

Document de découverte

Un document de découverte est une spécification lisible par machine qui permet de décrire et d'utiliser 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 posséder 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://curationpartners.googleapis.com

Ressource REST : v1.curators.curatedPackages

Méthodes
activate POST /v1/{name=curators/*/curatedPackages/*}:activate
Active un package sélectionné existant.
create POST /v1/{parent=curators/*}/curatedPackages
Crée un package organisé.
deactivate POST /v1/{name=curators/*/curatedPackages/*}:deactivate
Désactive un package sélectionné existant.
get GET /v1/{name=curators/*/curatedPackages/*}
Récupère un package organisé en fonction de son nom de ressource.
list GET /v1/{parent=curators/*}/curatedPackages
Répertorie les packages sélectionnés appartenant au curateur spécifié.
patch PATCH /v1/{curatedPackage.name=curators/*/curatedPackages/*}
Met à jour un package organisé existant.

Ressource REST : v1.curators.dataSegments

Méthodes
activate POST /v1/{name=curators/*/dataSegments/*}:activate
Active un segment de données.
create POST /v1/{parent=curators/*}/dataSegments
Crée un segment de données appartenant au curateur listé.
deactivate POST /v1/{name=curators/*/dataSegments/*}:deactivate
Désactive un segment de données.
get GET /v1/{name=curators/*/dataSegments/*}
Récupère un segment de données en fonction de son nom.
list GET /v1/{parent=curators/*}/dataSegments
Répertoriez les segments de données appartenant à un curateur.
patch PATCH /v1/{dataSegment.name=curators/*/dataSegments/*}
Met à jour un segment de données.

Ressource REST : v1.curators.reports

Méthodes
create POST /v1/{parent=curators/*}/reports
Crée un objet Report.
delete DELETE /v1/{name=curators/*/reports/*}
Supprime un objet Report.
get GET /v1/{name=curators/*/reports/*}
Récupère un objet Report.
list GET /v1/{parent=curators/*}/reports
Répertorie les objets Report.
patch PATCH /v1/{report.name=curators/*/reports/*}
Met à jour un objet Report.
run POST /v1/{name=curators/*/reports/*}:run
Lance l'exécution d'un rapport existant de manière asynchrone.

Ressource REST : v1.curators.reports.operations

Méthodes
get GET /v1/{name=curators/*/reports/*/operations/*}
Récupère le dernier état d'une opération de longue durée.

Ressource REST : v1.curators.reports.results

Méthodes
fetchRows GET /v1/{name=curators/*/reports/*/results/*}:fetchRows
Renvoie les lignes de résultats d'un rapport terminé.

Ressource REST : v1.mediaPlanners

Méthodes
list GET /v1/mediaPlanners
Répertorie tous les comptes de média-planner auxquels l'appelant a accès.
search GET /v1/mediaPlanners:search
Recherche les comptes de média-planner correspondant à l'ID de compte de DSP indiqué.