Informacje o wersjach

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 Filters zostały wycofane:

    Wartości Filter

    FILTER_DFP_ORDER_ID

    FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_INSERTION_ORDER

    FILTER_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 wyliczeniowyWartości
    ReportType INVENTORY_AVAILABILITY

  • Te filtry zostały wycofane:

    Wartości filtra

    FILTER_DETAILED_DEMOGRAPHICS

    FILTER_DETAILED_DEMOGRAPHICS_ID

    FILTER_HOUSEHOLD_INCOME

    FILTER_LIFE_EVENT

    FILTER_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_AGE

    FILTER_TRUEVIEW_IAR_CATEGORY

    FILTER_TRUEVIEW_IAR_CITY

    FILTER_TRUEVIEW_IAR_COUNTRY

    FILTER_TRUEVIEW_IAR_COUNTRY_NAME

    FILTER_TRUEVIEW_IAR_GENDER

    FILTER_TRUEVIEW_IAR_INTEREST

    FILTER_TRUEVIEW_IAR_LANGUAGE

    FILTER_TRUEVIEW_IAR_PARENTAL_STATUS

    FILTER_TRUEVIEW_IAR_REGION_NAME

    FILTER_TRUEVIEW_IAR_REMARKETING_LIST

    FILTER_TRUEVIEW_IAR_TIME_OF_DAY

    FILTER_TRUEVIEW_IAR_YOUTUBE_CHANNEL

    FILTER_TRUEVIEW_IAR_YOUTUBE_VIDEO

    FILTER_TRUEVIEW_IAR_ZIPCODE

    FILTER_YOUTUBE_CHANNEL

    FILTER_YOUTUBE_VIDEO

  • Wycofaliśmy te dane:

    Wartości danych

    METRIC_POTENTIAL_VIEWS

    METRIC_TEA_TRUEVIEW_IMPRESSIONS

    METRIC_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 będą uwzględniać tylko dane o wysokim poziomie ufności. 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 filtraDostępne wartości
    FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID

    0: 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_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPAPV_USD
  • METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPA_USD
  • METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPCV_USD
  • METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPC_USD
  • METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_ECPM_USD
  • METRIC_TOTAL_MEDIACOST_PARTNER
  • METRIC_TOTAL_MEDIACOST_USD
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
  • METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
  • METRIC_FEE32_ADVERTISER
  • METRIC_FEE32_PARTNER
  • METRIC_FEE32_USD

Tworzenie lub uruchamianie zasobów Query z wartością params.type równą 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_PATH
  • PATH_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_ENVIRONMENT
  • METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
  • METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
  • METRIC_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:

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

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.