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:
- Das Hinzufügen einer
queries.reports.get
-Methode. - Das Hinzufügen eines
orderBy
-Abfrageparameters zuqueries.reports.list
. - Die Aktualisierung des
queries.run
-Antworttexts von einem leeren Objekt auf eine Instanz der generiertenReport
-Ressource.
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
Der Dienstendpunkt wurde geändert:
v1-Dienstendpunkt v2-Dienstendpunkt https://www.googleapis.com/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
Die Dienste wurden wie folgt umbenannt:
v1-Dienst Dienst Version 2 Suchanfragen Abfragen Berichte queries.reports Methoden wurden wie folgt umbenannt:
Die folgenden Methoden wurden hinzugefügt:
Dienst Methode(n) queries.reports get Die folgenden Methoden haben einen neuen Antworttext:
Methode Neues Antworttextobjekt queries.run Bericht Die folgenden Felder wurden entfernt:
Ressource Feld(er) queries.list
AntworttextTyp
queries.reports.list
AntworttextTyp
Abfrage Typ
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Der Objekttyp der folgenden Felder wurde wie folgt geändert:
Ressource Feld(er) Objektart Abfrage Bericht RunQueryRequest Die folgenden Abfrageparameter für Methoden wurden hinzugefügt:
Methode Suchparameter queries.list orderBy queries.reports.list orderBy queries.run synchron Die folgenden Abfrageparameter für Methoden wurden entfernt:
Methode Suchparameter queries.create asynchron queries.run asynchron Die folgenden Filterwerte wurden hinzugefügt:
Filterwert FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Die folgenden Filterwerte wurden entfernt:
Filterwert FILTER_TRUEVIEW_IAR_REGION Die folgenden Messwerte wurden hinzugefügt:
Messwert 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
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.