Historia zmian

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

18.06.2026 Dodano metodę UpdateReportingIdentitySettings

18.06.2026 Dodano pole can_edit do PropertySummary

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

14.04.2026 Dodano metodę GetUserProvidedDataSettings

2025-08-20 Dodano metodę GetReportingIdentitySettings

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

20 sierpnia 2025 r. – usunięto starsze metody Universal Analytics

Z interfejsu Admin API w wersji v1alpha usunęliśmy te starsze metody Universal Analytics (UA): SetAutomatedGa4ConfigurationOptOut, FetchAutomatedGa4ConfigurationOptOut, CreateConnectedSiteTag, DeleteConnectedSiteTag, ListConnectedSiteTags i FetchConnectedGa4Property.

12.06.2025 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 v1alpha.

16.04.2025 Dodano metody zarządzania adnotacjami danych do raportu.

Dodano metody CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation i DeleteReportingDataAnnotation do zarządzania zasobami ReportingDataAnnotation za pomocą interfejsu Admin API w wersji v1alpha.

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 został wycofany i będzie zawsze zwracać wartość false. Pole zostanie usunięte z interfejsu Google Analytics Admin API w wersji 1beta w czerwcu 2025 r.

20 stycznia 2025 r. Dodaliśmy do artykułu DataRetentionSettings informacje o przechowywaniu danych użytkowników.

Dodano pole userDataRetention do DataRetentionSettings w interfejsie Admin API w wersji 1 alpha i 1 beta. Użyj tego pola, aby pobrać lub zmodyfikować ustawienia przechowywania danych użytkownika.

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

Dokumentacja metody runAccessReport została zaktualizowana i zawiera teraz link do formularza opinii o raportach dostępu w Google Analytics. Twoja opinia jest dla nas bardzo ważna i zachęcamy do podzielenia się swoimi przemyśleniami 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 v1alpha.

Dodano pole dataset_location do zasobu BigQueryLink.

Dodaliśmy zmiany połączenia z BigQuery do historii zmian w ramach nowej wartości BIGQUERY_LINK 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 dostosować ją do wytycznych dotyczących metod niestandardowych.

1 sierpnia 2024 r. Dodano zarządzanie regułami edycji zdarzeń.

Do interfejsu Admin API w wersji v1alpha dodano metody GetEventEditRule, CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules i ReorderEventEditRules.

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

1 sierpnia 2024 r. – różne zmiany

Dodano rolę create_time do zasobu Audience.

Do zasobu ChannelGroup dodaliśmy pole primary, które wskazuje, czy grupa kanałów jest domyślną grupą kanałów w raportach. W danym momencie tylko jedna grupa kanałów może mieć ustawienie primary o wartości true. Ustawienie parametru primary na true w przypadku grupy kanałów automatycznie ustawia parametr primary na false w przypadku poprzedniej głównej grupy kanałów.

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

6 maja 2024 r. Dodano metody zarządzania kluczowymi zdarzeniami.

Dostępne są teraz zasoby i metody dotyczące kluczowych zdarzeń.

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

15.12.2023 Raporty dostępu do danych są już dostępne we wszystkich usługach w Google Analytics.

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

Więcej informacji znajdziesz w dokumentacji schematu.

15.12.2023 Do schematu raportu dostępu do danych dodano wymiar accessDateHour.

Do schematu raportu dostępu do danych dodano wymiar accessDateHour. Zawiera datę i godzinę uzyskania przez użytkownika Google Analytics dostępu do danych do raportu Google Analytics.

5 października 2023 r. Usługi z modelami atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji” domyślnie przechodzą na atrybucję opartą 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 będą niedostępne w przypadku metody UpdateAttributionSettings we wszystkich usługach.

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

1 września 2023 r. Dodano metody konfiguracji schematu wartości konwersji SKAdNetwork.

GetSKAdNetworkConversionValueSchema, CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas dodane do interfejsu Admin API w wersji v1alpha.

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

1 września 2023 r. Dodano metodę UpdateConversionEvent.

UpdateConversionEvent dodana do interfejsu Admin API w wersji 1 beta.

1 września 2023 r. – nazwa pola BigQueryLink.enterprise_export_enabled została zmieniona na fresh_daily_export_enabled.

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

14.07.2023 Zmiany powodujące niezgodność w metodach properties.updateAttributionSettings i properties.getAttributionSettings.

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

Nazwy elementów typu wyliczeniowego 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

Nazwy elementów typu wyliczeniowego AdsWebConversionDataExportScope zostaną zmienione w ten sposób:

Stara nazwa Nowa nazwa
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 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.

5 czerwca 2023 r. 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 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 będą niedostępne we wszystkich usługach.

Więcej informacji znajdziesz w ogłoszeniu dotyczącym usługi Google Analytics.

Do interfejsu Admin API w wersji v1alpha dodano metody GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink i ListAdSenseLinks.

Ta funkcja umożliwia zarządzanie połączeniami AdSense z Analytics w przypadku usługi w GA4.

31.05.2023 Dodano metodę wyszukiwania połączonej usługi w GA4.

Metoda FetchConnectedGa4Property dodana do interfejsu Admin API w wersji v1alpha

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 v1alpha dodano metody CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules i GetEventCreateRule.

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

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

Do interfejsu Admin API w wersji v1alpha dodano metody GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup i DeleteChannelGroup.

Ta funkcja umożliwia zarządzanie niestandardowymi grupami kanałów w przypadku ź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.

31.03.2023 Dodaliśmy metody zarządzania ustawieniami pomiaru zaawansowanego.

Do interfejsu Admin API w wersji 1alpha 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 w GA4.

31.03.2023 Dodano metody zarządzania połączonymi tagami witryny.

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

Ta funkcja umożliwia zarządzanie połączonymi tagami witryny i jest przydatna do przekierowywania 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 dodano metody properties.runAccessReport i accounts.runAccessReport. Metody zwracają niestandardowy raport dotyczący rekordów dostępu do danych.

24.02.2023 Dodaliśmy metody zarządzania rozwiniętymi zbiorami danych.

Zasób ExpandedDataSet został dodany do wersji v1alpha interfejsu API 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 oraz te operacje:

Ta funkcja umożliwia zarządzanie uprawnieniami użytkowników na koncie lub w usłudze GA4 i powinna być używana zamiast User Links.

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

24 lutego 2023 r. Wycofanie metod kontroli zgód użytkowników.

Te metody zostały wycofane i zostaną usunięte z interfejsu Admin API w wersji 1 alpha 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 grupami odbiorców w usłudze w GA4.

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

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

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

Do wersji v1alpha interfejsu API dodaliśmy zasób BigQueryLink oraz odpowiednie operacje 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 i properties.searchAds360Links.get.

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

15.02.2023 Zmiany powodujące niezgodność.

15.02.2023 – różne zmiany.

11.08.2022 Dodano metodę runAccessReport do interfejsu Admin API w wersji 1alpha.

Metoda properties.runAccessReport została dodana do wersji v1alpha interfejsu Admin API. Zwraca on raport niestandardowy z rekordami dostępu do danych. Raport zawiera informacje o każdym przypadku odczytania przez użytkownika danych 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ę 1beta interfejsu Admin API.

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

W przypadku interfejsu Admin API nadal obsługiwane są zarówno kanały wersji alfa, jak i beta. Wersja beta zawiera podzbiór funkcji dostępnych w wersji alfa, które są uważane za stabilne i nie powinny ulec znacznym zmianom w przyszłości. Nowe funkcje będą dodawane do wersji beta, gdy zostaną dopracowane.

12 października 2021 r. – metody EnhancedMeasurementSettings zostały usunięte z interfejsu API.

  • Metody properties.webDataStreams.getEnhancedMeasurementSettings i properties.webDataStreams.updateEnhancedMeasurementSettings zostały usunięte z interfejsu API, ale ustawienia pomiaru zaawansowanego będzie można wkrótce ponownie modyfikować za pomocą interfejsu API.
  • Pole directRoles zasobu UserLink nie obsługuje już roli predefinedRoles/manage-users. Zamiast tego 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 w zarządzaniu dostępem i ograniczeniami dotyczącymi danych wprowadzonymi w Google Analytics.

5 czerwca 2021 r. Dodano funkcje.

Do interfejsu API dodano te funkcje:

  • Do interfejsu API dodano metodę accounts.searchChangeHistoryEvents. Ta metoda wyszukuje wszystkie zmiany na koncie lub jego elementach podrzędnych na podstawie określonego zestawu filtrów. Typowe przyczyny to aktualizacje wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez obsługę klienta lub automatyczne zmiany w systemie Google Analytics.
  • Metody zarządzania tajnymi kluczami platformy Measurement Protocol dodane w properties.dataStreams.measurementProtocolSecrets:
    • create Tworzy obiekt tajny Measurement Protocol.
    • delete Usuwa docelowy obiekt tajny platformy Measurement Protocol.
    • get Wyszukiwanie pojedynczego obiektu tajnego platformy Measurement Protocol.
    • list Zwraca tajne klucze podrzędne platformy Measurement Protocol w określonej usłudze nadrzędnej.
    • patch Aktualizuje obiekt tajny platformy Measurement Protocol.
  • Metody zarządzania zdarzeniami konwersji dodane 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.
  • Metody zarządzania wymiarami niestandardowymi dodane w 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.
  • Metody zarządzania danymi niestandardowymi dodane w properties.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 metody properties.getGoogleSignalsSettings i properties.updateGoogleSignalsSettings, które umożliwiają kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4.
  • Do typu Property dodano pola tylko do odczytu delete_time i expire_time.

5 czerwca 2021 r. Zmiany powodujące niezgodność.

Wprowadzono następujące zmiany powodujące niezgodność:

  • Z interfejsu API usunięto metody properties.iosAppDataStreams.create i properties.androidAppDataStreams.create. Aby utworzyć strumienie danych z aplikacji w usłudze w Google Analytics 4, użyj Firebase.
  • Metoda properties.delete zwraca teraz usunięte dane właściwości jako typ Property zamiast pustej odpowiedzi.
  • Pole time_zone typu Property jest teraz wymagane.
  • Pole deleted zostało usunięte z typu Property.
  • Pole email_address typu UserLink jest teraz niezmienne.
  • Pole name typu UserLink jest teraz tylko do odczytu.

28.01.2021 Zmiany powodujące niezgodność.

Zmiany powodujące niezgodność: – Pole update_mask jest wymagane we wszystkich operacjach aktualizacji.

  • Zmieniono nazwę pola country_code na region_code w: Account.

  • Zmieniono nazwę pola url_query_parameter na uri_query_parameter w: EnhancedMeasurementSettings.

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

20 października 2020 r. Dodano obsługę podsumowań kont.

Dodaliśmy obsługę metody account summaries.

13 października 2020 r. Usługi Aplikacje + internet zmieniły nazwę na Google Analytics 4 (GA4).

15 sierpnia 2020 r. Interfejs Management App + Web API został przemianowany na Admin API.

Interfejs Google Analytics Management App + Web API został przemianowany na Google Analytics Admin API. W rezultacie punkt końcowy API zmienił się na analyticsadmin.googleapis.com. Dotychczasowy kod napisany dla poprzedniej wersji adresu URL punktu końcowego API i bibliotek klienta musi zostać odpowiednio zaktualizowany.