Auf dieser Seite finden Sie Versionshinweise für die Google Bid Manager API.
Neueste API-Version: v2
1. März 2025
Neue Funktionen
Bekannte Probleme
Der Bericht zur Inventarverfügbarkeit für YouTube-TrueView-Anzeigen 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 wurden eingestellt:
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.
Nach der Einführung werden bei Suchanfragen, die diesen Filter nicht enthalten, standardmäßig nur Daten mit hoher Zuverlässigkeit berücksichtigt. Ab dem 4. Februar 2025 enthalten Abfragen, die diesen Filter nicht enthalten, standardmäßig Daten mit geringerer Wahrscheinlichkeit.
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 Wahrscheinlichkeit einbeziehen. (Standardeinstellung vor dem 4. Februar 2025)
1. Oktober 2024:
Neue Funktionen
Keine.
Bekannte Probleme
v2
Einstellung der Berichtsdimension „Modellierung von anonymem Inventar“
Die Dimension FILTER_ANONYMOUS_INVENTORY_MODELING ist „Sonnenuntergang“.
Wenn Sie Query-Ressourcen mit Einstellungswerten in params.groupBy erstellen oder ausführen, wird der Fehler 400 zurückgegeben.
Die 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 einer params.type von YOUTUBE und einem relevanten Messwert in params.metrics erstellen oder ausführen, wird der Fehler 400 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 Objekts Options wird ebenfalls eingestellt.
28. Februar 2024
Neue Funktionen
Keine.
Bekannte Probleme
v2
Einstellung der Werte für Messwerte zu geräteübergreifenden Conversions
Messwerte zu geräteübergreifenden Conversions werden eingestellt. Die folgenden Bid Manager API-Messwerte 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
Die Bid Manager API 2 wurde veröffentlicht.
Es wurden strukturelle Änderungen an der API vorgenommen, einschließlich der Aktualisierung des Dienstendpunkts und der Umbenennung von Diensten und Methoden.
Die Ressourcen Abfrage und Bericht wurden erheblich aktualisiert, indem unnötige Felder entfernt, vorhandene Felder neu angeordnet und Feldtypen geändert wurden. Dazu gehört auch, Feldtypen so zu ändern, dass benannte Objekte anstelle einer allgemeinen Definition für „verschachtelte Objekte“ verwendet werden.
Es ist erforderlich, Ad-hoc-Abfragen mit der Methode queries.run auszuführen, anstatt sie nach dem Erstellen automatisch ausführen zu lassen.
Der Abfrageparameter asynchronous des queries.run-Parameters wurde durch synchronous ersetzt.
Vereinfachter Berichtsabruf durch die folgenden Änderungen:
- Die Methode
queries.reports.getwurde hinzugefügt. - Dem
queries.reports.listwurde der AbfrageparameterorderByhinzugefügt. - Aktualisierung des
queries.run-Antworttexts von einem leeren Objekt zu einer Instanz der generiertenReport-Ressource.
Die von der API zurückgegebenen Fehlermeldungen wurden aktualisiert, um präziser zu sein und konkretere 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 Abfragen Berichte queries.reports Die 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 den folgenden 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 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.
Vorherige Releases
Informationen zu früheren Releases der Bid Manager API für eingestellte Versionen finden Sie in den archivierten Versionshinweisen.