Versionshinweise

Diese Seite enthält Versionshinweise für die Google Bid Manager API.

Version 2

Es wurden strukturelle Änderungen an der API vorgenommen, einschließlich der Aktualisierung des Dienstendpunkts und der Umbenennung von Diensten und Methoden.

Ressourcen für Abfragen und Berichte wurden erheblich aktualisiert, indem unnötige Felder entfernt, vorhandene Felder neu organisiert und Feldtypen geändert wurden. Dazu gehört auch, Feldtypen so zu ändern, dass benannte Objekte anstelle einer allgemeinen Definition eines verschachtelten Objekts verwendet werden.

Erforderliche Ausführung von Ad-hoc-Abfragen mit der Methode queries.run statt automatisch nach der Erstellung.

Der queries.run-Abfrageparameter asynchronous wurde durch synchronous ersetzt.

Das Abrufen von Berichten wurde durch die folgenden Änderungen vereinfacht:

Die von der API zurückgegebenen Fehlermeldungen wurden aktualisiert, um spezifischer zu sein und präskriptivere Lösungen bereitzustellen.

Folgen Sie der Anleitung im Migrationsleitfaden für Version 2, um von Version 1.1 zu Version 2 zu migrieren.

Neue Funktionen

Bekannte Probleme

Keine.

Version 1.1

1:1-Filter für die Zuordnung von Berichtsspalten

Filter, die mehreren Berichtsspalten zugeordnet sind, werden jetzt einzelnen Spalten zugeordnet.

Wenn Sie in V1 beispielsweise den Filter FILTER_ADVERTISER verwenden, wird ein Bericht mit den Spalten „Werbetreibender“ zusätzlich zu „Werbetreibenden-ID“ generiert. In v1.1 haben alle Berichtsspalten ihre eigenen Filter. Der neue Filter FILTER_ADVERTISER_NAME wird beispielsweise „Werbetreibender“ zugeordnet. Um in Berichten die Spalten „Werbetreibenden-ID“ und „Werbetreibender“ zu erhalten, müssen die beiden Filter FILTER_ADVERTISER und FILTER_ADVERTISER_NAME in Queries.createquery-Anfragen enthalten sein.

Genauer gesagt, die createquery-Anfrage:

{
...
"params": {
  ...
  "groupBys": ["FILTER_ADVERTISER"],
  "metrics": ["METRIC_IMPRESSIONS"],
  ...
}
...
}

erstellt eine Berichtsdatei mit den folgenden Überschriften in v1:

Advertiser,Advertiser ID,Advertiser Status,Advertiser Integration Code,Impressions

und die folgenden Header in v1.1:

Advertiser,Impressions

Der folgende V1-Code, der im obigen Beispiel zum Abrufen von Berichtsspalten verwendet wurde:

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);

muss in v1.1 in etwa so geändert werden (Anordnung der Filterreihenfolge beachten):

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);
Ursprünglicher Filter Hinzugefügte Filter
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

Seitenumbruch

In Version 1.1 wird den Methoden Queries.listqueries und Reports.listreports eine Paginierung hinzugefügt.

In Version 1.1 entspricht die Anzahl der Ergebnisse, die von diesen Methoden zurückgegeben werden, dem neu hinzugefügten Parameter pageSize. Wenn kein Wert angegeben ist, wird standardmäßig 100 verwendet. Die Antworten enthalten das neu hinzugefügte Feld nextPageToken, mit dem die nächsten Ergebnisse abgerufen werden können. Dieses Feld ist leer, wenn die Ergebnisse ausgeschöpft sind.

Mit dem folgenden Code von Version 1 können Sie alle Berichte abrufen, die zu einer bestimmten Abfrage gehören:

public class GetReports {
  public List<Report> getReports(DoubleClickBidManager service, long queryId) throws IOException {
    ListReportsResponse reportListResponse = service.reports().listreports(queryId).execute();

    return reportListResponse.getReports();
  }
}

muss in v1.1 ähnlich wie folgt geändert werden, damit weiterhin alle Berichte abgerufen werden:

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;
  }
}

Weitere Informationen finden Sie in der Dokumentation zu den Methoden Queries.listqueries und Reports.listreports.

Bekannte Probleme

Keine.

Version 1

Dies ist die ursprüngliche Version der API.

Bekannte Probleme

Keine.