Historia zmian

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

18 czerwca 2026 r. Dodano metodę UpdateReportingIdentitySettings

18.06.2026 Dodano pole can_edit do PropertySummary

  • Dodaliśmy pole can_edit do zasobu PropertySummary w interfejsie Admin API w wersjach v1alpha i v1beta. To pole wskazuje, czy użytkownik ma w Google Analytics rolę, która umożliwia mu zmianę ustawień usługi.

14 kwietnia 2026 r. Dodano metodę GetUserProvidedDataSettings

2025-08-20 Dodano metodę GetReportingIdentitySettings

Dodaliśmy do interfejsu Admin API w wersji 1alpha metodę GetReportingIdentitySettings, która umożliwia pobieranie ReportingIdentitySettings usługi.

20.08.2025 Usunięto starsze metody Universal Analytics

Z interfejsu Admin API w wersji 1alpha usunięto te starsze metody Universal Analytics (UA): SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags i FetchConnectedGa4Property.

12 czerwca 2025 r. Dodano metody zarządzania konfiguracją synchronizacji usług podrzędnych

Dodano metody GetSubpropertySyncConfig, ListSubpropertySyncConfig i UpdateSubpropertySyncConfig do zarządzania zasobami SubpropertySyncConfig za pomocą interfejsu Admin API w wersji 1alpha.

16 kwietnia 2025 r. Dodano metody zarządzania adnotacjami danych do raportu

Dodaliśmy metody CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation i DeleteReportingDataAnnotation do zarządzania zasobami ReportingDataAnnotation za pomocą interfejsu Admin API w wersji 1alpha.

Adnotacje umożliwiają użytkownikom dodawanie notatek bezpośrednio do raportów Google Analytics, co ułatwia rejestrowanie zdarzeń, wyjaśnianie zmian w danych i podkreślanie najważniejszych spostrzeżeń dla siebie i swojego zespołu.

7 marca 2025 r. Wycofanie parametru sharingWithGoogleAnySalesEnabled

Parametr sharingWithGoogleAnySalesEnabled metody getDataSharingSettings jest teraz wycofany i zawsze zwraca wartość false. To pole zostanie usunięte z interfejsu Google Analytics Admin API w wersji 1beta w czerwcu 2025 r.

20.01.2025 Dodano przechowywanie danych użytkowników do DataRetentionSettings

Dodano pole userDataRetention do DataRetentionSettings w interfejsach Admin API w wersjach 1 alfa i 1 beta. Użyj tego pola, aby pobrać lub zmodyfikować ustawienia przechowywania danych użytkowników.

2024-09-09 Formularz ankiety dotyczącej dostępu do raportów

Dokumentacja metody runAccessReport została zaktualizowana i zawiera teraz link do formularza opinii o raportach dostępu do Google Analytics. Cenimy Twoją opinię i zachęcamy do podzielenia się swoimi uwagami na temat tego interfejsu API, aby pomóc nam go ulepszyć.

Dodano metody CreateBigQueryLink, UpdateBigQueryLink i DeleteBigQueryLink do zarządzania zasobami BigQueryLink za pomocą interfejsu Admin API w wersji 1alpha.

Dodano pole dataset_location do zasobu BigQueryLink.

Dodaliśmy zmiany w połączeniu z BigQuery do historii zmian w sekcji BIGQUERY_LINK wartość w ChangeHistoryResourceType.

1 sierpnia 2024 r. Zmiana powodująca niezgodność w metodzie createSubproperty

Zmieniliśmy nazwę metody niestandardowej createSubproperty na provisionSubproperty w interfejsie Admin API w wersji 1alpha, aby była zgodna z wytycznymi dotyczącymi metod niestandardowych.

2024-08-01 Dodano zarządzanie regułami edycji wydarzeń

GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, metody dodane do interfejsu Admin API w wersji 1alpha.

EventEditRule określa warunki, które spowodują utworzenie zupełnie nowego zdarzenia na podstawie kryteriów zdarzenia źródłowego. Dodatkowo EventEditRule może definiować modyfikacje parametrów ze zdarzenia źródłowego.

2024-08-01 Różne zmiany

Dodano create_time do zasobu Audience.

Dodano primary do zasobu ChannelGroup, aby wskazać, czy grupa kanałów jest domyślną grupą kanałów na potrzeby raportów. Tylko 1 grupa kanałów może mieć w danej chwili ustawioną wartość primary na true. Ustawienie wartości primary na true w przypadku grupy kanałów automatycznie ustawia wartość primary na false w przypadku poprzedniej głównej grupy kanałów.

Dodano gmp_organization do zasobu Account, który zawiera URI zasobu organizacji w Google Marketing Platform, jeśli konto jest połączone z organizacją GMP.

2024-05-06 Dodano metody zarządzania kluczowymi zdarzeniami

Zasoby i metody dotyczące kluczowych zdarzeń są już dostępne.

Zmodyfikuj integrację interfejsu API, aby używała metody KeyEvent zamiast ConversionEvent. Środowisko wykonawcze ConversionEvent zostało wycofane.

15 grudnia 2023 r. Raporty o dostępie do danych są teraz dostępne w przypadku wszystkich usług w Google Analytics.

Niektóre pola funkcji Raporty dostępu do danych są teraz dostępne dla wszystkich klientów korzystających z usług w Google Analytics, zarówno w wersji standardowej, jak i Google Analytics 360.

Więcej informacji znajdziesz w dokumentacji schematu.

15 grudnia 2023 r. Do schematu raportu Dostęp do danych dodano wymiar accessDateHour.

Wymiar accessDateHour dodany do schematu raportu o dostępie do danych. Zawiera godzinę, o której użytkownik Google Analytics uzyskał dostęp do danych do raportu Google Analytics.

2023-10-05 Usługi z modelami atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji” domyślnie korzystają z atrybucji opartej na danych w wielu kanałach.

Od połowy października 2023 r. modele atrybucji Pierwsze kliknięcie, Liniowy, Spadek udziału z upływem czasu i Uwzględnienie pozycji nie będą dostępne w przypadku wszystkich usług w metodzie UpdateAttributionSettings.

Jeśli Twoja usługa jest obecnie skonfigurowana tak, aby korzystać z jednego z tych modeli, zostanie on zmieniony na atrybucję opartą na danych w wielu kanałach. Nadal będziesz mieć możliwość używania modelu „Ostatnie kliknięcie w wielu kanałach” lub „Preferowane ostatnie kliknięcie w Google Ads”.

2023-09-01 Dodaliśmy metody konfigurowania schematu wartości konwersji SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas metody dodane do interfejsu Admin API w wersji 1alpha.

Ta funkcja umożliwia zarządzanie konfiguracją schematu wartości konwersji SKAdNetwork w przypadku strumienia iOS.

2023-09-01 Dodano metodę UpdateConversionEvent.

UpdateConversionEvent metoda dodana do interfejsu Admin API w wersji 1 beta.

2023-09-01 Pole BigQueryLink.enterprise_export_enabled zostało zmienione na fresh_daily_export_enabled.

Pole enterprise_export_enabled zasobu BigQueryLink zostało zmienione na fresh_daily_export_enabled.

14 lipca 2023 r. Zmiany powodujące niezgodność w metodach properties.updateAttributionSettings i properties.getAttributionSettings.

24 lipca 2023 r. w interfejsie Admin API w wersji 1 alfa zostaną wprowadzone zmiany powodujące niezgodność wsteczną, które wpłyną na działanie metod properties.getAttributionSettings i properties.updateAttributionSettings.

Elementy wyliczenia ReportingAttributionModel zostaną zmienione w ten 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

Elementy wyliczenia AdsWebConversionDataExportScope zostaną zmienione w ten sposób:

Stara nazwa Nowa nazwa
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10 lipca 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óre można modyfikować za pomocą metody UpdateAttributionSettings.

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

Od czerwca 2023 r. nie będzie można używać metody UpdateAttributionSettings do konfigurowania usług w GA4 za pomocą modeli 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 we wszystkich usługach.

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

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks metody dodane do interfejsu Admin API w wersji v1alpha.

Ta funkcja umożliwia zarządzanie połączeniami między AdSense a Analytics w przypadku usługi w GA4.

2023-05-31 Dodano metodę wyszukiwania połączonej usługi w GA4.

Metoda FetchConnectedGa4Property dodana do interfejsu Admin API w wersji 1alpha

Ta funkcja umożliwia uzyskanie informacji o usłudze w GA4 połączonej z usługą w Universal Analytics podczas procesu migracji do GA4.

31.05.2023 Dodano metodę zarządzania regułami tworzenia zdarzeń.

Do interfejsu Admin API w wersji 1alpha dodaliśmy metody CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule.

Ta funkcja umożliwia zarządzanie regułami tworzenia zdarzeń, które mogą uruchamiać tworzenie zupełnie nowego zdarzenia na podstawie dopasowanych kryteriów zdarzenia źródłowego.

31 maja 2023 r. Dodano metody zarządzania niestandardowymi grupami kanałów.

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

Ta funkcja umożliwia zarządzanie niestandardowymi grupami kanałów dla źródeł wizyt w witrynie.

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

2023-03-31 Dodano metody zarządzania ustawieniami pomiaru zaawansowanego.

Do interfejsu Admin API w wersji 1 alfa dodano metody properties.dataStreams.updateEnhancedMeasurementSettings i properties.dataStreams.getEnhancedMeasurementSettings.

Ta funkcja umożliwia zarządzanie ustawieniami pomiaru zaawansowanego w przypadku strumienia danych z sieci w usłudze GA4.

31.03.2023 Dodaliśmy metody zarządzania połączonymi tagami witryny.

Do interfejsu Admin API w wersji 1alpha dodaliśmy metody properties.createConnectedSiteTag, properties.deleteConnectedSiteTag i properties.listConnectedSiteTags.

Ta funkcja umożliwia zarządzanie połączonymi tagami witryny i jest przydatna do przekazywania ruchu z usługi w Universal Analytics do usługi w Google Analytics 4.

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

Do wersji v1beta interfejsu Admin API dodaliśmy metody properties.runAccessReport i accounts.runAccessReport. Metody zwracają dostosowany raport rekordów dostępu do danych.

24 lutego 2023 r. Dodaliśmy metody zarządzania rozwiniętymi zbiorami danych.

Do wersji v1alpha interfejsu API dodaliśmy zasób ExpandedDataSet wraz z odpowiednimi operacjami properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list i properties.expandedDataSets.get. Tej funkcji można używać do zarządzania rozwiniętymi zbiorami danych w Google Analytics 360.

Do wersji v1alpha interfejsu API dodano zasób AccessBinding wraz z tymi operacjami:

Ta funkcja umożliwia zarządzanie uprawnieniami użytkowników na koncie lub w usłudze w GA4 i należy jej używać zamiast funkcji Połączenia z użytkownikami.

Funkcja User Links zostanie usunięta z interfejsu Admin API w wersji 1alpha 1 czerwca 2023 r.

2023-02-24 Wycofanie metod audytu zgód użytkowników.

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

24.02.2023 Dodano metody zarządzania odbiorcami.

Do wersji v1alpha interfejsu API dodano zasób Audience wraz z odpowiednimi operacjami: properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list i properties.audience.get.

Ta funkcja umożliwia zarządzanie listami odbiorców w usłudze w GA4.

15 lutego 2023 r. Dodaliśmy metody rezygnacji z automatycznej konfiguracji GA4.

Do wersji v1alpha interfejsu API dodaliśmy operacje properties.setAutomatedGa4ConfigurationOptOut i properties.fetchAutomatedGa4ConfigurationOptOut.

Ta funkcja umożliwia zarządzanie stanem rezygnacji z automatycznej konfiguracji GA4 w przypadku usługi w UA.

Do wersji v1alpha interfejsu API dodaliśmy zasób BigQueryLink wraz z odpowiednimi operacjami properties.bigQueryLinks.get i properties.bigQueryLinks.list.

Ta funkcja umożliwia pobieranie informacji o połączeniach między usługą w GA4 a projektem BigQuery.

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

Ta funkcja umożliwia zarządzanie połączeniami między usługą w GA4 a elementem Search Ads 360.

15 lutego 2023 r. Zmiany powodujące niezgodność.

15 lutego 2023 r. Różne zmiany.

11 sierpnia 2022 r. runAccessReport dodano metodę do interfejsu Admin API w wersji 1alpha.

Metoda properties.runAccessReport została dodana do wersji v1alpha interfejsu Admin API. Zwraca raport niestandardowy rekordów dostępu do danych. Raport zawiera zapisy każdej sytuacji, w której użytkownik odczytuje dane do raportu Google Analytics. Raporty dostępu do danych są dostępne dla administratorów usług w Google Analytics 360.

11 lipca 2022 r. Udostępniliśmy wersję 1 beta interfejsu Admin API.

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

W przypadku interfejsu Admin API nadal obsługiwane są kanały wersji alfa i beta. Wersja beta zawiera podzbiór funkcji dostępnych w wersji alfa, które są uważane za stabilne i nie powinny w przyszłości ulec znacznym zmianom. Gdy nowe funkcje będą gotowe, dodamy je do wersji beta.

12 października 2021 r. Usunięcie z interfejsu API metod EnhancedMeasurementSettings.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings methods are removed from the API, but Enhanced Measurement settings will again be modifiable via API soon.
  • Pole directRoles zasobu UserLink nie obsługuje już roli predefinedRoles/manage-users. Zamiast nich należy używać nowej roli predefinedRoles/admin, która jest odpowiednikiem połączenia starych ról predefinedRoles/edit i predefinedRoles/manage-users. Ta zmiana wpływa na działanie metod accounts.userLinks i properties.userLinks i jest zgodna ze zmianami wprowadzonymi w Google Analytics w zakresie zarządzania dostępem i ograniczeniami dotyczącymi danych.

2021-06-05 Dodano funkcje.

Do interfejsu API dodano te funkcje:

  • accounts.searchChangeHistoryEvents dodano do interfejsu API. Ta metoda przeszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych na podstawie określonego zestawu filtrów. Typowe przyczyny to zmiany wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez zespół obsługi klienta lub automatyczne zmiany w systemie Google Analytics.
  • Dodaliśmy metody zarządzania tajnymi kluczami platformy Measurement Protocol w sekcjiproperties.dataStreams.measurementProtocolSecrets:
    • create Tworzy tajny klucz API do platformy Measurement Protocol.
    • delete Usuwa docelowy klucz Measurement Protocol.
    • get Wyszukiwanie pojedynczego tajnego klucza platformy Measurement Protocol.
    • list Zwraca tajne klucze interfejsu Measurement Protocol usługi podrzędnej w określonej usłudze nadrzędnej.
    • patch Aktualizuje obiekt tajny platformy Measurement Protocol.
  • Dodano metody zarządzania zdarzeniami konwersji w sekcji properties.conversionEvents:
    • create Tworzy zdarzenie konwersji z określonymi atrybutami.
    • delete Usuwa zdarzenie konwersji w usłudze.
    • get Pobieranie pojedynczego zdarzenia konwersji.
    • list Zwraca listę zdarzeń konwersji w określonej usłudze nadrzędnej.
  • Dodano metody zarządzania wymiarami niestandardowymi w sekcji properties.customDimensions:
    • archive Archiwizuje wymiar niestandardowy w usłudze.
    • create Tworzy wymiar niestandardowy.
    • get Wyszukiwanie pojedynczego wymiaru niestandardowego.
    • list Wyświetla listę wymiarów niestandardowych w usłudze.
    • patch Aktualizuje wymiar niestandardowy w usłudze.
  • Dodaliśmy metody zarządzania danymi niestandardowymi w sekcjiproperties.customMetrics:
    • archive Archiwizuje dane niestandardowe w usłudze.
    • create Tworzy dane niestandardowe.
    • get Wyszukiwanie pojedynczych danych niestandardowych.
    • list Wyświetla listę danych niestandardowych w usłudze.
    • patch Aktualizuje dane niestandardowe w usłudze.
  • Dodano properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings metody, które umożliwiają kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4.
  • delete_time, expire_time do typu Property dodano pola tylko do odczytu.

2021-06-05 Zmiany powodujące niezgodność.

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

  • properties.iosAppDataStreams.create i properties.androidAppDataStreams.create zostały usunięte z interfejsu API. Do tworzenia strumieni danych z aplikacji w usłudze w Google Analytics 4 używaj Firebase.
  • Metoda properties.delete zwraca teraz usunięte dane usługi jako typ Property zamiast pustej odpowiedzi.
  • Pole time_zone typu Property jest teraz wymagane.
  • Usunięto pole deleted z typu Property.
  • Pole email_address typu UserLink jest teraz niezmienne.
  • name pole typu UserLink jest teraz tylko danymi wyjściowymi.

28 stycznia 2021 r. Zmiany powodujące niezgodność.

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

  • Zmieniono nazwę pola country_code na region_code w Account.

  • Zmieniono nazwę pola url_query_parameter na uri_query_parameter w EnhancedMeasurementSettings.

  • Usunięto pole parent z GoogleAdsLink.

2020-10-20 Dodano obsługę podsumowań kont.

Dodaliśmy obsługę metody podsumowania kont.

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

15.08.2020 Aplikacja do zarządzania i interfejs Web API zostały zmienione na Admin API.

Interfejs API zarządzania usługą Aplikacje + internet w Google Analytics został zmieniony na interfejs Google Analytics Admin API. W związku z tym punkt końcowy interfejsu API został zmieniony na analyticsadmin.googleapis.com. Należy odpowiednio zaktualizować dotychczasowy kod napisany pod kątem poprzedniej wersji adresu URL punktu końcowego interfejsu API i bibliotek klienta.