Cette page fournit les notes de version de l'API Google Bid Manager.
Version 2
Modifications structurelles de l'API, y compris la mise à jour du point de terminaison du service et le changement de nom des services et des méthodes
Mise à jour importante des ressources Query et Report, avec suppression des champs inutiles, réorganisation des champs existants et modification des types de champs. Cela inclut la modification des types de champs pour utiliser des objets nommés au lieu d'une définition générale d'"objet imbriqué".
Nécessite l'exécution de requêtes ponctuelles à l'aide de la méthode queries.run
au lieu de les exécuter automatiquement après la création.
Remplacement du paramètre de requête queries.run
asynchronous
par synchronous
.
Récupération des rapports simplifiée grâce aux modifications suivantes:
- Ajout d'une méthode
queries.reports.get
. - Ajout d'un paramètre de requête
orderBy
àqueries.reports.list
. - Mise à jour du corps de la réponse
queries.run
d'un objet vide vers une instance de la ressourceReport
générée.
Mise à jour des messages d'erreur renvoyés par l'API pour être plus spécifiques et fournir des solutions plus normatives.
Suivez les instructions présentées dans le guide de migration de la version 2 pour passer de la version 1.1 à la version 2.
Nouvelles fonctionnalités
Le point de terminaison du service a été modifié:
Point de terminaison de service v1 Point de terminaison de service v2 https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
Les services ont été renommés comme suit:
Service v1 Service v2 Requêtes des requêtes Rapports queries.reports Les méthodes ont été renommées comme suit:
Les méthodes suivantes ont été ajoutées:
Service Méthode(s) queries.reports get Les méthodes suivantes ont un nouveau corps de réponse:
Méthode Nouvel objet "Corps de la réponse" queries.run Rapport Les champs suivants ont été supprimés :
Ressource Champ(s) Corps de la réponse queries.list
kind
Corps de la réponse queries.reports.list
kind
Requête kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Le type d'objet des champs suivants a été modifié comme suit:
Ressource Champ(s) Type d'objet Requête Rapport RunQueryRequest Les paramètres de requête de méthode suivants ont été ajoutés:
Méthode Paramètres de requête queries.list orderBy queries.reports.list orderBy queries.run synchrone Les paramètres de requête de méthode suivants ont été supprimés:
Méthode Paramètres de requête queries.create l'application queries.run l'application Les valeurs de filtre suivantes ont été ajoutées:
Valeur du filtre FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Les valeurs de filtre suivantes ont été supprimées:
Valeur du filtre FILTER_TRUEVIEW_IAR_REGION Les valeurs de métriques suivantes ont été ajoutées:
Valeur de métrique METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Problèmes connus
Aucune
Version 1.1
Filtre un à un pour le mappage des colonnes d'un rapport
Les filtres mappés à plusieurs colonnes du rapport correspondent désormais à des colonnes individuelles.
Par exemple, dans la version 1, inclure le filtre FILTER_ADVERTISER
génère un rapport contenant les colonnes "Annonceur" en plus "Référence annonceur". Dans la version 1.1, toutes les colonnes
du rapport ont leurs propres filtres. Par exemple, un nouveau filtre FILTER_ADVERTISER_NAME
est mappé sur "Annonceur". Pour que les colonnes "Référence annonceur" et "Annonceur" soient incluses dans les rapports, les filtres FILTER_ADVERTISER
et FILTER_ADVERTISER_NAME
doivent respectivement être inclus dans les demandes Queries.createquery
.
Plus concrètement, la requête createquery
:
{
...
"params": {
...
"groupBys": ["FILTER_ADVERTISER"],
"metrics": ["METRIC_IMPRESSIONS"],
...
}
...
}
génère un fichier de rapport avec les en-têtes suivants dans la version 1:
Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions
et les en-têtes suivants dans la version 1.1:
Advertiser,Impressions
Dans l'exemple ci-dessus, le code v1 suivant permet d'obtenir les colonnes du rapport:
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
devront être modifiées comme suit dans la version 1.1 (ordre des filtres de notes):
List<String> groupBys = new ArrayList<>();
groupBys.add("FILTER_ADVERTISER_NAME");
groupBys.add("FILTER_ADVERTISER");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_STATUS");
groupBys.add("FILTER_ADVERTISER_INTEGRATION_CODE");
List<String> metrics = new ArrayList<>();
metrics.add("METRIC_IMPRESSIONS");
com.google.api.services.doubleclickbidmanager.model.Parameters createQueryParameters =
new com.google.api.services.doubleclickbidmanager.model.Parameters()
.setGroupBys(groupBys)
.setMetrics(metrics);
Filtre d'origine | Filtres ajoutés |
---|---|
FILTER_ADVERTISER |
FILTER_ADVERTISER_NAME FILTER_ADVERTISER_INTEGRATION_CODE FILTER_ADVERTISER_INTEGRATION_STATUS |
FILTER_AD_POSITION |
FILTER_AD_POSITION_NAME |
FILTER_CARRIER |
FILTER_CARRIER_NAME |
FILTER_CHANNEL_ID |
FILTER_CHANNEL_NAME |
FILTER_CITY |
FILTER_CITY_NAME |
FILTER_COMPANION_CREATIVE_ID |
FILTER_COMPANION_CREATIVE_NAME |
FILTER_DMA |
FILTER_DMA_NAME |
FILTER_INSERTION_ORDER |
FILTER_INSERTION_ORDER_NAME |
FILTER_PARTNER |
FILTER_PARTNER_NAME FILTER_PARTNER_STATUS |
FILTER_REGION |
FILTER_REGION_NAME |
FILTER_TRUEVIEW_DMA |
FILTER_TRUEVIEW_DMA_NAME |
FILTER_TRUEVIEW_IAR_REGION |
FILTER_TRUEVIEW_IAR_REGION_NAME |
FILTER_USER_LIST_FIRST_PARTY |
FILTER_USER_LIST_FIRST_PARTY_NAME |
FILTER_USER_LIST_THIRD_PARTY |
FILTER_USER_LIST_THIRD_PARTY_NAME |
Pagination
La version 1.1 ajoute la pagination aux méthodes Queries.listqueries
et Reports.listreports
.
Dans la version 1.1, le nombre de résultats renvoyés par ces méthodes est égal à un nouveau paramètre pageSize
(la valeur par défaut est 100
s'il n'est pas spécifié). Les réponses contiennent un champ nextPageToken
récemment ajouté, qui permet de récupérer l'ensemble de résultats suivant. Ce champ est vide si les résultats sont épuisés.
Le code v1 suivant pour récupérer tous les rapports appartenant à une requête spécifique:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
return reportListResponse.getReports();
}
}
devront être modifiées comme suit dans la version 1.1, pour que vous puissiez continuer à récupérer tous les rapports:
public class GetReports {
public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();
List<Report> reports = new ArrayList<>(reportListResponse.getReports());
while (reportListResponse.getNextPageToken() != null
&& reportListResponse.getNextPageToken().length() > 0) {
// Get next set of results, aka page.
reportListResponse =
service
.reports()
.listreports(queryId)
.setPageToken(reportListResponse.getNextPageToken())
.execute();
reports.addAll(reportListResponse.getReports());
}
return reports;
}
}
Pour en savoir plus, consultez la documentation sur les méthodes Queries.listqueries
et Reports.listreports
.
Problèmes connus
Aucune
Version 1
Il s'agit de la version initiale de l'API.
Problèmes connus
Aucune