Na tej stronie znajdziesz informacje o wersjach interfejsu Google Bid Manager API.
Najnowsza wersja interfejsu API: 2
22 września 2025 r.
Znane problemy
Wycofujemy 3 wartości wyliczeniowe Filter z powodu niskiego poziomu wykorzystania, o czym informowaliśmy wcześniej w Centrum pomocy Display & Video 360.
v2
Te
Filterszostały wycofane:Wartości FilterFILTER_DFP_ORDER_IDFILTER_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1 marca 2025 r.
Znane problemy
Wycofanie raportu dostępności zasobów reklamowych TrueView w YouTube i powiązanych z nim wymiarów, o czym informowaliśmy wcześniej w Centrum pomocy Display & Video 360.
v2
Te wartości wyliczenia zostały wycofane:
Typ wyliczeniowy Wartości ReportTypeINVENTORY_AVAILABILITYTe filtry zostały wycofane:
Wartości filtra 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_VIDEOWycofaliśmy te dane:
Wartości danych METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 listopada 2024 r.
Nowe funkcje
Uruchamia się FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID. Umożliwia to uwzględnianie danych o niższym poziomie ufności w przypadku danych z tymi prefiksami:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Jeśli używasz tego filtra, musisz uwzględnić co najmniej 1 odpowiedni rodzaj danych.
Po uruchomieniu zapytania, które nie zawierają tego filtra, będą domyślnie działać tak jak wcześniej, czyli uwzględniać tylko dane o wysokim poziomie zaufania. Od 4 lutego 2025 r. zapytania, które nie zawierają tego filtra, będą domyślnie uwzględniać dane o niższym poziomie ufności.
v2
Dodano te filtry:
Typ filtra Dostępne wartości FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: uwzględnij dane o niższym poziomie zaufania. (Domyślne po 4 lutego 2025 r.)1: uwzględniaj tylko dane o wysokim poziomie zaufania. (Domyślne przed 4 lutego 2025 r.)
1 października 2024 r.
Nowe funkcje
Brak.
Znane problemy
v2
Wycofanie wymiaru raportowania Modelowanie anonimowych zasobów reklamowych
Wymiar FILTER_ANONYMOUS_INVENTORY_MODELING to zachód słońca.
Tworzenie lub uruchamianie zasobów Query
z użyciem wartości zachodu słońca w params.groupBy
zwraca błąd 400.
Dane DST/ROC (ustawowe koszty operacyjne) i całkowity koszt mediów są niezgodne z raportami YOUTUBE.
W raportach YOUTUBE nie można już używać tych wartości danych:
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
Tworzenie lub uruchamianie zasobów Query z wartością params.type YOUTUBE i odpowiednią wartością danych w params.metrics powoduje zwrócenie błędu 400.
1 maja 2024 r.
Nowe funkcje
Brak.
Znane problemy
v2
Wycofanie raportów Pełna ścieżka i Atrybucja ścieżki
Raporty Pełna ścieżka i Atrybucja ścieżki zostały wycofane. Pobieranie lub tworzenie tych typów zasobów Query i Report powoduje błąd.
Te wartości ReportType są wycofywane:
FULL_PATHPATH_ATTRIBUTION
Pole pathQueryOptions obiektu Options również zostało wycofane.
28 lutego 2024 r.
Nowe funkcje
Brak.
Znane problemy
v2
Wycofanie wartości danych o konwersjach na różnych urządzeniach
Dane o konwersjach na różnych urządzeniach zostaną wycofane. Obejmuje on te wartości danych interfejsu Bid Manager API:
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 lipca 2022 r.
Nowe funkcje
Wprowadziliśmy Bid Manager API w wersji 2.
Wprowadzono zmiany strukturalne w interfejsie API, w tym zaktualizowano punkt końcowy usługi oraz zmieniono nazwy usług i metod.
Znacznie zaktualizowaliśmy zasoby Zapytanie i Raport, usuwając niepotrzebne pola, zmieniając kolejność istniejących pól i zmieniając typy pól. Obejmuje to zmianę typów pól, aby używać nazwanych obiektów zamiast ogólnej definicji „obiektu zagnieżdżonego”.
Wymagane jest uruchamianie zapytań ad hoc za pomocą metody queries.run zamiast automatycznego uruchamiania ich po utworzeniu.
Zastąpiliśmy parametr zapytania queries.run asynchronous parametrem synchronous.
Uproszczone pobieranie raportów dzięki tym zmianom:
- Dodanie metody
queries.reports.get. - Dodanie parametru zapytania
orderBydoqueries.reports.list. - Aktualizacja treści odpowiedzi
queries.runz pustego obiektu na instancję wygenerowanego zasobuReport.
Zaktualizowaliśmy komunikaty o błędach zwracane przez interfejs API, aby były bardziej szczegółowe i zawierały bardziej precyzyjne rozwiązania.
Aby przejść z wersji 1.1 na wersję 2, postępuj zgodnie z instrukcjami podanymi w przewodniku po migracji do wersji 2.
v2
Punkt końcowy usługi został zmieniony:
Punkt końcowy usługi w wersji 1 Punkt końcowy usługi w wersji 2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comNazwy usług zostały zmienione w ten sposób:
usługa w wersji 1 usługa w wersji 2, Zapytania zapytania Raporty queries.reports Nazwy metod zostały zmienione w ten sposób:
Dodaliśmy te metody:
Usługa Metody queries.reports get Poniższe metody mają nową treść odpowiedzi:
Metoda Nowy obiekt treści odpowiedzi queries.run Zgłoś Usunęliśmy te pola:
Zasób Pola queries.listTreść odpowiedzirodzaj
queries.reports.listTreść odpowiedzirodzaj
Zapytanie rodzaj
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
Typ obiektu w tych polach został zmieniony na:
Zasób Pola Typ obiektu Zapytanie Zgłoś RunQueryRequest Dodaliśmy te parametry zapytania metody:
Metoda Parametry zapytania queries.list orderBy queries.reports.list orderBy queries.run synchroniczne Usunęliśmy te parametry zapytania metody:
Metoda Parametry zapytania queries.create asynchroniczne queries.run asynchroniczne Dodano te wartości filtra:
Wartość filtra FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Usunęliśmy te wartości filtra:
Wartość filtra FILTER_TRUEVIEW_IAR_REGION Dodaliśmy te wartości danych:
Wartość wskaźnika 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
Znane problemy
Brak.
Poprzednie wersje
Informacje o poprzednich wersjach interfejsu Bid Manager API, które zostały wycofane, znajdziesz w naszych zarchiwizowanych informacjach o wersji.