Auf dieser Seite finden Sie Versionshinweise zur Google Bid Manager API.
Neueste API-Version: v2
22. September 2025
Bekannte Probleme
Die drei Filter-Enum-Werte werden aufgrund geringer Nutzung eingestellt. Das wurde bereits in der Display & Video 360-Hilfe angekündigt.
v2
Die folgenden
Filterswurden eingestellt:Filter-Wert(e)FILTER_DFP_ORDER_IDFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1. März 2025
Bekannte Probleme
Der Bericht zur Inventarverfügbarkeit für YouTube TrueView und die zugehörigen Dimensionen werden eingestellt, wie bereits in der Display & Video 360-Hilfe angekündigt.
v2
Die folgenden Enum-Werte wurden eingestellt:
Enum Wert(e) ReportTypeINVENTORY_AVAILABILITYDie folgenden Filter wurden eingestellt:
Filterwert(e) FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEODie folgenden Messwerte werden nicht mehr unterstützt:
Messwert(e) METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20. November 2024
Neue Funktionen
FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID wird gestartet. So können Daten mit niedrigerem Konfidenzwert für Messwerte mit den folgenden Präfixen einbezogen werden:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Bei Verwendung dieses Filters muss einer der relevanten Messwerte enthalten sein.
Bei der Einführung wird für Abfragen, die diesen Filter nicht enthalten, standardmäßig das bisherige Verhalten verwendet, bei dem nur Daten mit hoher Zuverlässigkeit berücksichtigt werden. Ab dem 4. Februar 2025 werden bei Abfragen, die diesen Filter nicht enthalten, standardmäßig Daten mit geringerer Konfidenz berücksichtigt.
v2
Die folgenden Filter wurden hinzugefügt:
Filtertyp Verfügbare Werte FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: Daten mit niedrigerem Konfidenzniveau einbeziehen. (Standardeinstellung nach dem 4. Februar 2025)1: Nur Daten mit hoher Konfidenz einbeziehen. (Standard vor dem 4. Februar 2025)
1. Oktober 2024:
Neue Funktionen
Keine.
Bekannte Probleme
v2
Einstellung der Berichtsdimension „Modellierung von anonymem Inventar“ (AIM)
Die Dimension FILTER_ANONYMOUS_INVENTORY_MODELING wird eingestellt.
Wenn Sie Query-Ressourcen mit den Sunset-Werten in params.groupBy erstellen oder ausführen, wird ein 400-Fehler zurückgegeben.
Messwerte zu DST/ROC (gesetzliche Betriebskosten) und Mediagesamtkosten sind nicht mehr mit YOUTUBE-Berichten kompatibel.
Die folgenden Messwertwerte können nicht mehr in YOUTUBE-Berichten verwendet werden:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
Wenn Sie Query-Ressourcen mit einem params.type von YOUTUBE und einem relevanten Messwert in params.metrics erstellen oder ausführen, wird ein 400-Fehler zurückgegeben.
1. Mai 2024
Neue Funktionen
Keine.
Bekannte Probleme
v2
Einstellung der Berichte „Vollständiger Pfad“ und „Pfadattribution“
Die Berichte „Vollständiger Pfad“ und „Pfadattribution“ werden eingestellt. Das Abrufen oder Erstellen dieser Arten von Query- und Report-Ressourcen führt zu einem Fehler.
Die folgenden ReportType-Werte werden eingestellt:
FULL_PATHPATH_ATTRIBUTION
Das Feld pathQueryOptions des Options-Objekts wird ebenfalls eingestellt.
28. Februar 2024
Neue Funktionen
Keine.
Bekannte Probleme
v2
Einstellung von Messwerten zu geräteübergreifenden Conversions
Messwerte zu geräteübergreifenden Conversions werden eingestellt. Die folgenden Messwertwerte der Bid Manager API sind enthalten:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6. Juli 2022
Neue Funktionen
Bid Manager API v2 wurde veröffentlicht.
Es wurden strukturelle Änderungen an der API vorgenommen, darunter die Aktualisierung des Dienstendpunkts und die Umbenennung von Diensten und Methoden.
Die Ressourcen Query und Report wurden erheblich aktualisiert. Dazu wurden unnötige Felder entfernt, vorhandene Felder neu organisiert und Feldtypen geändert. Dazu gehört auch, Feldtypen so zu ändern, dass benannte Objekte anstelle einer allgemeinen Definition für „verschachteltes Objekt“ verwendet werden.
Ad-hoc-Abfragen müssen mit der Methode queries.run ausgeführt werden, anstatt automatisch nach der Erstellung.
Der Abfrageparameter queries.run asynchronous wurde durch synchronous ersetzt.
Vereinfachter Abruf von Berichten durch die folgenden Änderungen:
- Die Methode
queries.reports.getwurde hinzugefügt. - Der Abfrageparameter
orderBywird zuqueries.reports.listhinzugefügt. - Die Aktualisierung des Antworttexts
queries.runvon einem leeren Objekt zu einer Instanz der generierten RessourceReport.
Die von der API zurückgegebenen Fehlermeldungen wurden aktualisiert, um spezifischer zu sein und genauere Lösungen zu bieten.
Folgen Sie der Anleitung im Migrationsleitfaden für Version 2, um von Version 1.1 zu Version 2 zu migrieren.
v2
Der Dienstendpunkt wurde geändert:
v1-Dienstendpunkt v2-Dienstendpunkt https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comDie Dienste wurden wie folgt umbenannt:
v1-Dienst v2-Dienst Suchanfragen Suchanfragen 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.listAntworttextTyp
queries.reports.listAntworttextTyp
Abfrage Typ
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Der Objekttyp der folgenden Felder wurde in Folgendes geändert:
Ressource Feld(er) Objektart Abfrage Bericht RunQueryRequest Die folgenden Methodenabfrageparameter wurden hinzugefügt:
Methode Suchparameter queries.list orderBy queries.reports.list orderBy queries.run synchron Die folgenden Methodenabfrageparameter 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 Messwertwerte 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.
Frühere Releases
Informationen zu früheren Bid Manager API-Releases für eingestellte Versionen finden Sie in unseren archivierten Versionshinweisen.