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 czerwca 2026 r. Dodano pole can_edit do PropertySummary

  • Dodano pole can_edit do zasobu PropertySummary w interfejsach Admin API v1alpha i v1beta. To pole informuje, czy użytkownik ma w Google Analytics rolę, która pozwala mu zmieniać ustawienia usługi.

2026-04-14 Dodano metodę GetUserProvidedDataSettings

2025-08-20 Dodano metodę GetReportingIdentitySettings

Dodaliśmy do interfejsu Admin API w wersji alfa 1 metodę GetReportingIdentitySettings, która umożliwia pobieranie ReportingIdentitySettings dla 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.04.2025 Dodano metody zarządzania adnotacjami danych raportowania

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

2025-01-20 Dodano przechowywanie danych użytkowników do DataRetentionSettings

Dodano pole userDataRetention do DataRetentionSettings w interfejsach Admin API w wersjach alfa 1 i beta 1. 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 Twoje uwagi i zachęcamy do podzielenia się opinią 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

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

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

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

EventEditRuleokreśla warunki, które spowodują utworzenie zupełnie nowego zdarzenia na podstawie kryteriów zdarzenia źródłowego. Dodatkowo EventEditRule może zdefiniować 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 w przypadku grupy kanałów automatycznie ustawia wartość false w przypadku poprzedniej głównej grupy kanałów.primarytrue

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

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

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

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

15 grudnia 2023 r. Raporty dotyczące dostępu do danych są teraz dostępne we wszystkich usługach 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 modelu DDA 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 zamiast niego modelu Ostatnie kliknięcie w wielu kanałach lub Preferowane ostatnie kliknięcie w Google Ads.

1.09.2023 Dodaliśmy metody konfiguracji schematu wartości konwersji SKAdNetwork.

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

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

2023-09-01 Dodano metodę UpdateConversionEvent.

UpdateConversionEvent dodana do interfejsu Admin API w wersji 1 beta.

Pole 2023-09-01 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:

Poprzednia 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:

Poprzednia 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 1alpha.

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 alfa 1

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

2023-05-31 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. Dodaliśmy 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 ź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 alfa 1 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 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 dodano 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 konta lub usługi w GA4 i należy jej używać zamiast funkcji Połączenia z użytkownikami.

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

24 lutego 2023 r. Wycofanie metod audytu uprawnień 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 lutego 2023 r. Dodano metody zarządzania odbiorcami.

Do wersji v1alpha interfejsu API dodaliśmy 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 automatycznego procesu konfiguracji GA4.

Do wersji v1alpha interfejsu API dodano 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 dodano zasób BigQueryLink wraz z odpowiednimi operacjami properties.bigQueryLinks.get, properties.bigQueryLinks.list.

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

Do wersji v1alpha interfejsu API dodaliśmy zasób SearchAds360Link 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 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 dodana do wersji v1alpha interfejsu Admin API. Zwraca dostosowany raport z rekordami 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 znaczącym zmianom. Gdy nowe funkcje będą gotowe, dodamy je do wersji beta.

12 października 2021 r. Usunięto z interfejsu API metody EnhancedMeasurementSettings.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings zostaną usunięte z interfejsu API, ale ustawienia pomiarów ulepszonych będzie można wkrótce ponownie modyfikować za pomocą interfejsu API.
  • Pole directRoles w zasobie 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 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 w zarządzaniu dostępem i ograniczeniami dotyczącymi danych wprowadzonymi w Google Analytics.

2021-06-05 Dodano funkcje.

Do interfejsu API dodano te funkcje:

  • Do interfejsu API dodano metodę accounts.searchChangeHistoryEvents. Ta metoda wyszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych na podstawie określonego zestawu filtrów. Typowe przyczyny to aktualizacje wprowadzone w interfejsie Google Analytics, zmiany dokonane 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 Measurement Protocol.
    • delete Usuwa docelowy klucz tajny Measurement Protocol.
    • get Wyszukiwanie pojedynczego tajnego klucza platformy Measurement Protocol.
    • list Zwraca tajne klucze Measurement Protocol usługi podrzędnej w określonej usłudze nadrzędnej.
    • patch Aktualizuje tajny klucz 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.
  • Dodano metody zarządzania danymi niestandardowymi w sekcji 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, properties.updateGoogleSignalsSettings umożliwiające kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4.
  • delete_time, expire_time do typu Property dodano pola tylko do danych wyjściowych.

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

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

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create metody 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 zwracać pustą odpowiedź.
  • Pole time_zone typu Property jest teraz wymagane.
  • Usunięto pole deleted z typu Property.
  • Pole email_address typu UserLink jest teraz niezmienne.
  • Pole name 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 account summaries.

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

15.08.2020 Interfejs Management App + Web API został zmieniony na Admin API.

Interfejs API zarządzania usługami Aplikacje + internet w Google Analytics został zmieniony na interfejs Google Analytics Admin API. W związku z tym punkt końcowy API został zmieniony na analyticsadmin.googleapis.com. Istniejący kod napisany w oparciu o poprzednią wersję adresu URL punktu końcowego API i bibliotek klienta wymaga odpowiedniej aktualizacji.