Historia zmian

Aby otrzymywać oficjalne ogłoszenia o interfejsie API Google Analytics, zasubskrybuj grupę powiadomień o interfejsie Google Analytics API.

15.12.2023 Raporty o dostępie do danych są teraz dostępne we wszystkich usługach w Google Analytics.

Niektóre pola funkcji Raporty o dostępie do danych są teraz dostępne we wszystkich usługach w Google Analytics, zarówno w przypadku klientów standardowych, jak i klientów Google Analytics 360.

Więcej informacji znajdziesz w dokumentacji schematu.

15.12.2023 – wymiar accessDateHour został dodany do schematu raportu Dostęp do danych.

Wymiar accessDateHour został dodany do schematu raportu o dostępie do danych. Zawiera on godzinę, kiedy użytkownik Google Analytics uzyskał dostęp do danych raportowania Google Analytics.

5.10.2023 r. W przypadku usług z modelami atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji” domyślnie wybrana jest atrybucja oparta na danych w wielu kanałach.

Od połowy października 2023 r. modeli atrybucji Pierwsze kliknięcie, Liniowy, Spadek udziału z upływem czasu i Uwzględnienie pozycji nie będzie można używać z metodą UpdateAttributionSettings w przypadku wszystkich usług.

Jeśli Twoja usługa jest obecnie skonfigurowana do używania jednego z tych modeli, zostanie zmieniona na atrybucję opartą na danych obejmującą różne kanały. Nadal będziesz mieć możliwość wyboru modelu „Ostatnie kliknięcie w wielu kanałach” lub „Preferowane ostatnie kliknięcie w Google Ads”.

1.09.2023 r. dodano metody konfiguracji schematu wartości konwersji SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas dodano do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać konfiguracją schematu wartości konwersji SKAdNetwork w przypadku strumienia iOS.

1.09.2023 r. dodano metodę UpdateConversionEvent.

Metoda UpdateConversionEvent została dodana do wersji beta interfejsu Admin API.

1.09.2023 r. zmieniono nazwę pola BigQueryLink.enterprise_export_enabled na fresh_daily_export_enabled.

Nazwa pola enterprise_export_enabled zasobu BigQueryLink została zmieniona na fresh_daily_export_enabled.

14.07.2023 r. Zmiany dotyczące metod properties.updateAttributionSettings, properties.getAttributionSettings.

Od 24 lipca 2023 r. w interfejsie Admin API w wersji 1 będą wprowadzane zmiany powodujące niezgodność, które będą miały wpływ na działanie metod properties.getAttributionSettings i properties.updateAttributionSettings.

Nazwy użytkowników listy ReportingAttributionModel zostaną zmienione w następujący sposób:

Stara nazwa Nowa nazwa
CROSS_CHANNEL_DATA_DRIVEN PAID_AND_ORGANIC_CHANNELS_DATA_DRIVEN
CROSS_CHANNEL_LAST_CLICK PAID_AND_ORGANIC_CHANNELS_LAST_CLICK
CROSS_CHANNEL_FIRST_CLICK PAID_AND_ORGANIC_CHANNELS_FIRST_CLICK
CROSS_CHANNEL_LINEAR PAID_AND_ORGANIC_CHANNELS_LINEAR
CROSS_CHANNEL_POSITION_BASED PAID_AND_ORGANIC_CHANNELS_POSITION_BASED
CROSS_CHANNEL_TIME_DECAY PAID_AND_ORGANIC_CHANNELS_TIME_DECAY
ADS_PREFERRED_LAST_CLICK GOOGLE_PAID_CHANNELS_LAST_CLICK

Nazwy użytkowników listy AdsWebConversionDataExportScope zostaną zmienione w następujący sposób:

Stara nazwa Nowa nazwa
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 r. dodano pole ads_web_conversion_data_export_scope do typu AttributionSettings.

Dodano pole ads_web_conversion_data_export_scope do typu AttributionSettings, który można modyfikować za pomocą metody UpdateAttributionSettings.

5.06.2023 r. Wycofanie modeli atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji”.

Od czerwca 2023 r. metody UpdateAttributionSettings nie można używać do konfigurowania usług GA4 z modelami atrybucji Pierwsze kliknięcie, liniowy, Spadek udziału z upływem czasu i Uwzględnienie pozycji. Od września 2023 r. te modele staną się niedostępne w przypadku niektórych usług.

Więcej informacji znajdziesz w ogłoszeniu o usłudze Google Analytics.

Metody GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks zostały dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać połączeniami AdSense i Analytics w usłudze w GA4.

31.05.2023 r. dodaliśmy metodę wyszukiwania połączonej usługi w GA4.

Metoda FetchConnectedGa4Property dodana do interfejsu Admin API w wersji 1alfa

Ta funkcja pozwala uzyskać informacje o usłudze w GA4 połączonej z usługą w Universal Analytics w trakcie procesu migracji do GA4.

31 maja 2023 r. Dodaliśmy metodę zarządzania regułami tworzenia zdarzeń.

Metody CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać regułami tworzenia zdarzeń, które mogą uruchamiać tworzenie zupełnie nowego zdarzenia na podstawie spełniających kryteria zdarzenia źródłowego.

31.05.2023 r. dodaliśmy metody zarządzania niestandardowymi grupami kanałów.

Dodano metody GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać niestandardowymi grupami kanałów na potrzeby źródeł wizyt w witrynie.

Po utworzeniu niestandardowych grup kanałów można wysyłać zapytania za pomocą interfejsu Google Analytics Data API w wersji 1.

31.03.2023 r. dodaliśmy metody zarządzania Ustawienia pomiaru zaawansowanego.

Metody properties.dataStreams.updateEnhancedMeasurementSettings i properties.dataStreams.getEnhancedMeasurementSettings dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać ustawieniami pomiaru zaawansowanego w przypadku strumienia danych z sieci w usłudze w GA4.

31.03.2023 r. dodano metody zarządzania połączonymi tagami witryny.

Metody properties.createConnectedSiteTag, properties.deleteConnectedSiteTag i properties.listConnectedSiteTags dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja umożliwia zarządzanie połączonymi tagami witryny i przydaje się do przekierowania ruchu z usługi Universal Analytics do usługi Google Analytics 4.

31.03.2023 Do wersji beta interfejsu Admin API w wersji 1 beta dodaliśmy metody runAccessReport na poziomie konta i usługi.

Metody properties.runAccessReport i accounts.runAccessReport dodane do wersji v1beta interfejsu Admin API. Metody zwracają niestandardowy raport rekordów dostępu do danych.

24.02.2023 r. dodano metody zarządzania zbiorami danych.

Zasób ExpandedDataSet został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list, properties.expandedDataSets.get. Ta funkcja może służyć do zarządzania rozwiniętymi zbiorami danych w Google Analytics 360.

Zasób AccessBinding został dodany do wersji v1alpha interfejsu API wraz z tymi operacjami:

Ta funkcja pozwala zarządzać uprawnieniami użytkowników na koncie lub w usłudze GA4 i powinna być używana zamiast połączeń użytkowników.

1 czerwca 2023 r. funkcja Linki użytkowników zostanie usunięta z interfejsu Admin API w wersji 1 w wersji alfa

24.02.2023 r. Wycofujemy metody kontroli uprawnień użytkowników.

Te metody zostały wycofane i 1 czerwca 2023 r. zostaną usunięte z wersji alfa interfejsu Admin API:

24.02.2023 – dodano metody zarządzania odbiorcami.

Zasób Audience został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list, properties.audience.get.

Ta funkcja pozwala zarządzać listami odbiorców w usłudze w GA4.

15.02.2023 r. dodaliśmy metody rezygnacji w automatycznym procesie konfiguracji GA4.

Do wersji v1alpha interfejsu API dodano operacje properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut.

Ta funkcja pozwala zarządzać stanem rezygnacji w ramach zautomatyzowanego procesu konfiguracji GA4 w usłudze w UA.

Zasób BigQueryLink został dodany do wersji v1alpha interfejsu API wraz z odpowiednimi operacjami properties.bigQueryLinks.get i properties.bigQueryLinks.list.

Ta funkcja pozwala pobierać informacje o połączeniach między usługą w GA4 a projektem BigQuery.

Zasób SearchAds360Link został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list, properties.searchAds360Links.get.

Ta funkcja pozwala zarządzać połączeniami między usługą GA4 a elementem Search Ads 360.

15.02.2023 r. Najistotniejsze zmiany.

15.02.2023 r. Inne zmiany.

11.08.2022 r. została dodana do wersji 1alfa interfejsu Admin API metoda runAccessReport.

Metoda properties.runAccessReport dodana do wersji v1alpha interfejsu Admin API. Zwraca niestandardowy raport rekordów dostępu do danych. Raport zawiera zapis każdego odczytu przez użytkownika danych raportowania Google Analytics. Raporty o dostępie do danych są dostępne dla administratorów usług w Google Analytics 360.

11.07.2022 r. opublikowano wersję beta interfejsu Admin API.

Udostępniliśmy wersję beta interfejsu Google Analytics Admin API.

Zarówno kanał alfa, jak i beta interfejsu API jest nadal obsługiwany przez interfejs Admin API. Wersja beta zawiera podzbiór funkcji dostępnych w wersji alfa, które są uważane za stabilne i w przyszłości nie powinny podlegać znaczącej zmianie. Nowe funkcje będą dodawane do wersji beta w chwili ich dojrzewania.

12.10.2021 – usunięto z API metody EnhancedMeasurementSettings.

  • properties.webDataStreams.getEnhancedMeasurementSettings, metody properties.webDataStreams.updateEnhancedMeasurementSettings zostały usunięte z interfejsu API, ale wkrótce będzie można ponownie modyfikować ustawienia pomiaru zaawansowanego za pomocą interfejsu API.
  • Pole directRoles zasobu UserLink nie obsługuje już roli predefinedRoles/manage-users. Zamiast niej należy użyć nowej roli predefinedRoles/admin, która jest odpowiednikiem kombinacji starych ról predefinedRoles/edit i predefinedRoles/manage-users. Ta zmiana wpływa na działanie metod accounts.userLinks i properties.userLinks oraz jest zgodna ze zmianami dotyczącymi zarządzania dostępem i ograniczeniami dotyczącymi danych wprowadzonych w Google Analytics.

5.06.2021 r. Dodano funkcje.

Do interfejsu API dodane są te funkcje:

  • Do interfejsu API dodano metodę accounts.searchChangeHistoryEvents. Ta metoda przeszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych z uwzględnieniem określonego zestawu filtrów. Typowe przyczyny to zmiany wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez obsługę klienta lub automatyczne zmiany w systemie Google Analytics.
  • Metody zarządzania obiektami tajnymi platformy Measurement Protocol dodane w sekcji properties.webDataStreams.measurementProtocolSecrets:
    • create Tworzy obiekt tajny platformy Measurement Protocol.
    • delete Usuwa obiekt tajny platformy Measurement Protocol.
    • get Wyszukuje pojedynczy tajny klucz platformy Measurement Protocol.
    • list Zwraca tajne klucze podrzędne platformy Measurement Protocol w określonej usłudze nadrzędnej.
    • patch Aktualizuje tajny klucz platformy Measurement Protocol.
  • Metody zarządzania zdarzeniami konwersji dodane w sekcji properties.conversionEvents:
    • create Tworzy zdarzenie konwersji o określonych atrybutach.
    • delete Usuwa zdarzenie konwersji z usługi.
    • get Pobierz jedno zdarzenie konwersji.
    • listZwraca listę zdarzeń konwersji w określonej usłudze nadrzędnej.
  • Metody zarządzania wymiarami niestandardowymi dodane w sekcji properties.customDimensions:
    • archive Archiwizuje wymiar niestandardowy w usłudze.
    • create – tworzy wymiar niestandardowy.
    • get Wyszukaj pojedynczy wymiar niestandardowy.
    • list Zawiera listę wymiarów niestandardowych występujących w usłudze.
    • patch Aktualizuje wymiar niestandardowy w usłudze.
  • Metody zarządzania danymi niestandardowymi dodane w sekcji properties.customMetrics:
    • archive Archiwizuje dane niestandardowe w usłudze.
    • create ponownie odwołuje się do danych niestandardowych.
    • get Wyszukaj pojedynczy rodzaj danych niestandardowych.
    • list Zawiera listę danych niestandardowych związanych z usługą.
    • patch Aktualizuje w usłudze dane niestandardowe.
  • Dodano metody properties.getGoogleSignalsSettings i properties.updateGoogleSignalsSettings, które umożliwiają kontrolowanie ustawienia Google Signals w przypadku usługi Google Analytics 4.
  • delete_time, expire_time – tylko pola danych wyjściowych dodane do typu Property.

5.06.2021 r. Ważne zmiany.

Wprowadziliśmy te zmiany powodujące niezgodność:

  • properties.iosAppDataStreams.create, usunięto z interfejsu API properties.androidAppDataStreams.create metody. Użyj Firebase, aby utworzyć strumienie aplikacji w usłudze Google Analytics 4.
  • Zamiast zwracać pustą odpowiedź, metoda properties.delete zwraca teraz usunięte dane usługi jako typ Property.
  • Pole time_zone typu Property jest teraz wymagane.
  • Z typu Property usunięto pole deleted.
  • email_address typu UserLink jest teraz stałe.
  • name typu UserLink jest teraz tylko dane wyjściowe.

28.01.2021 Ważne zmiany.

Zmiany powodujące niezgodność: – pole update_mask jest wymagane w przypadku wszystkich operacji aktualizowania.

  • Nazwa pola country_code została zmieniona na region_code w Account.

  • Nazwa pola url_query_parameter została zmieniona na uri_query_parameter w EnhancedMeasurementSettings.

  • Pole parent zostało usunięte z GoogleAdsLink.

20.10.2020 Dodaliśmy obsługę podsumowań kont.

Dodaliśmy obsługę metody podsumowań kont.

13.10.2020 r.: usługi Aplikacje + internet zostały zmienione na Google Analytics 4 (GA4).

15.08.2020 – interfejs Management App + Web API zmienił nazwę na Admin API.

Interfejs Google Analytics Management Aplikacje + internet API to teraz Google Analytics Admin API. Z tego powodu punkt końcowy interfejsu API zmienił się na analyticsadmin.googleapis.com. Istniejący kod napisany na podstawie poprzedniej wersji adresu URL punktu końcowego interfejsu API oraz biblioteki klienta muszą zostać odpowiednio zaktualizowane.