Notes de version

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:

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

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