Historia zmian

Aby otrzymywać oficjalne ogłoszenia dotyczące interfejsu Google Analytics API, zasubskrybuj grupę Google Analytics API Notify.

2026-06-18 Dodano metodę UpdateReportingIdentitySettings

• Dodaliśmy metodę UpdateReportingIdentitySettings do interfejsu Admin API v1alpha, która umożliwia aktualizowanie ustawień ReportingIdentitySettings usługi.

2026-06-18 Dodano pole can_edit do PropertySummary

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

2026-04-14 Dodano metodę GetUserProvidedDataSettings

• Dodaliśmy metodę GetUserProvidedDataSettings do interfejsu Admin API v1alpha, która umożliwia pobieranie UserProvidedDataSettings usługi.

• Dodaliśmy zasób UserProvidedDataSettings do interfejsu Admin API v1alpha, który zawiera pola zbierania danych przekazywanych przez użytkowników userProvidedDataCollectionEnabled i automaticallyDetectedDataCollectionEnabled.

2025-08-20 Dodano metodę GetReportingIdentitySettings

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

2025-08-20 Usunięto starsze metody Universal Analytics

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

2025-06-12 Dodano metody zarządzania konfiguracją synchronizacji usług podrzędnych

Dodaliśmy GetSubpropertySyncConfig, ListSubpropertySyncConfig, i UpdateSubpropertySyncConfig metody do zarządzania zasobami SubpropertySyncConfig za pomocą interfejsu Admin API v1alpha.

2025-04-16 Dodano metody zarządzania adnotacjami w danych raportowania

Dodaliśmy CreateReportingDataAnnotation, GetReportingDataAnnotation, ListReportingDataAnnotations, UpdateReportingDataAnnotation i DeleteReportingDataAnnotation metody do zarządzania zasobami ReportingDataAnnotation za pomocą interfejsu Admin API 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.

2025-03-07 Wycofanie parametru sharingWithGoogleAnySalesEnabled

Parametr sharingWithGoogleAnySalesEnabled metody getDataSharingSettings został wycofany i zawsze będzie zwracać wartość false. To pole zostanie usunięte z interfejsu Google Analytics Admin API v1beta w czerwcu 2025 r.

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

Dodaliśmy pole userDataRetention do DataRetentionSettings w interfejsie Admin API v1alpha i v1beta. Użyj tego pola, aby pobrać lub zmodyfikować ustawienia przechowywania danych użytkowników.

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

Zaktualizowaliśmy dokumentację metody runAccessReport , dodając link do formularza opinii o raportach o dostępie w Google Analytics. Twoja opinia jest dla nas bardzo ważna. Zachęcamy do dzielenia się swoimi spostrzeżeniami na temat tego interfejsu API, aby pomóc nam go ulepszyć.

2024-08-01 Dodano zarządzanie połączeniami z BigQuery

Dodaliśmy CreateBigQueryLink, UpdateBigQueryLink, i DeleteBigQueryLink metody do zarządzania BigQueryLink zasobami za pomocą interfejsu Admin API v1alpha.

Dodaliśmy pole dataset_location do zasobu BigQueryLink.

Dodaliśmy zmiany połączeń z BigQuery do historii zmian pod nową BIGQUERY_LINK wartością w ChangeHistoryResourceType.

2024-08-01 Zmiana powodująca niezgodność w metodzie createSubproperty

Zmieniliśmy nazwę metody niestandardowej createSubproperty na provisionSubproperty w interfejsie Admin API v1alpha, 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, Dodaliśmy metody do interfejsu Admin API v1alpha.

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

2024-08-01 Różne zmiany

Dodaliśmy create_time do zasobu Audience.

Dodaliśmy primary do zasobu ChannelGroup, aby wskazać, czy grupa kanałów jest domyślną grupą kanałów w raportach. W danym momencie tylko 1 grupa kanałów może mieć ustawioną wartość primary na true. Ustawienie primary na true w przypadku grupy kanałów automatycznie ustawia primary na false w przypadku poprzedniej głównej grupy kanałów.

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

2024-05-06 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. ConversionEvent został wycofany.

2023-12-15 Raporty o dostępie do danych są teraz dostępne we wszystkich usługach Google Analytics.

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

Więcej informacji znajdziesz w dokumentacji schematu.

2023-12-15 Wymiar accessDateHour dodany do schematu raportu o dostępie do danych.

Wymiar accessDateHour dodany do schematu raportu o dostępie do danych. Zawiera on datę i godzinę użytkownika Google Analytics, który 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 obejmującej różne kanały.

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 korzystania z metody UpdateAttributionSettings we wszystkich usługach.

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

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

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

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

2023-09-01 Dodano metodę UpdateConversionEvent.

UpdateConversionEvent Dodaliśmy metodę do interfejsu Admin API v1beta.

2023-09-01 Zmieniono nazwę pola BigQueryLink.enterprise_export_enabled na fresh_daily_export_enabled.

Zmieniliśmy nazwę pola enterprise_export_enabled zasobu BigQueryLink na fresh_daily_export_enabled.

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

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

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

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

Poprzednia nazwa	Nowa nazwa
CROSS_CHANNEL	PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED	GOOGLE_PAID_CHANNELS

2023-07-10 Dodano pole ads_web_conversion_data_export_scope do typu AttributionSettings

Dodaliśmy 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 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 nie będą dostępne we wszystkich usługach.

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

2023-05-31 Dodano metody zarządzania połączeniami z AdSense.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks metody dodane do interfejsu Admin API 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.

Dodaliśmy metodę FetchConnectedGa4Property do interfejsu Admin API 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.

2023-05-31 Dodano metodę zarządzania regułami tworzenia zdarzeń.

Dodaliśmy metody CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule do interfejsu Admin API v1alpha.

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

2023-05-31 Dodano metody zarządzania niestandardowymi grupami kanałów.

Dodaliśmy GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup metody do interfejsu Admin API v1alpha.

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

Po utworzeniu niestandardowe grupy kanałów można wysyłać do nich zapytania za pomocą interfejsu Google Analytics Data API v1.

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

Dodaliśmy metody properties.dataStreams.updateEnhancedMeasurementSettings i properties.dataStreams.getEnhancedMeasurementSettings do interfejsu Admin API v1alpha.

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

2023-03-31 Dodano metody zarządzania połączonymi tagami witryny.

Dodaliśmy metody properties.createConnectedSiteTag, properties.deleteConnectedSiteTag i properties.listConnectedSiteTags do interfejsu Admin API v1alpha.

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.

2023-03-31 Dodano metody runAccessReport na poziomie konta i usługi do interfejsu Admin API v1beta.

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

2023-02-24 Dodano metody zarządzania rozwiniętymi zbiorami danych.

Dodaliśmy zasób ExpandedDataSet 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. Ta funkcja umożliwia zarządzanie rozwiniętymi zbiorami danych w Google Analytics 360.

2023-02-24 Powiązania dostępu zastępują linki użytkowników w zarządzaniu uprawnieniami użytkowników.

Dodaliśmy zasób AccessBinding do wersji v1alpha interfejsu API wraz z tymi operacjami:

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Ta funkcja umożliwia zarządzanie uprawnieniami użytkowników do konta lub usługi GA4 i powinna być używana zamiast linków użytkowników.

Funkcja linków użytkowników zostanie usunięta z interfejsu Admin API v1alpha 1 czerwca 2023 r.

2023-02-24 Wycofanie metod audytu uprawnień użytkowników.

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

• accounts.userLinks.audit
• properties.userLinks.audit

2023-02-24 Dodano metody zarządzania odbiorcami.

Dodaliśmy zasób Audience do wersji v1alpha interfejsu API wraz z odpowiednimi properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list i properties.audience.get operacjami.

Ta funkcja umożliwia zarządzanie odbiorcami w usłudze GA4.

2023-02-15 Dodano metody rezygnacji z automatycznej konfiguracji GA4.

properties.setAutomatedGa4ConfigurationOptOut i properties.fetchAutomatedGa4ConfigurationOptOut operacje zostały dodane do wersji v1alpha interfejsu API.

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

2023-02-15 Dodano metody zarządzania połączeniami z BigQuery.

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

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

2023-02-15 Dodano metody zarządzania połączeniami z Search Ads 360.

Dodaliśmy zasób SearchAds360Link 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 jednostką Search Ads 360.

2023-02-15 Zmiany powodujące niezgodność.

• Usunęliśmy wartości LESS_THAN_OR_EQUAL i GREATER_THAN_OR_EQUAL z wyliczenia NumericFilter.Operation.

• Usunęliśmy wartość PARTIAL_REGEXP z wyliczenia StringFilter.MatchType

2023-02-15 Różne zmiany.

• Dodaliśmy pole tokensPerProjectPerHour do AccessQuota typu.
• Dodaliśmy wartości EXPANDED_DATA_SET i CHANNEL_GROUP do wyliczenia ChangeHistoryResourceType enum.
• Dodaliśmy wartości searchAds360Link, expandedDataSet i bigqueryLink do ChangeHistoryResource.

2022-08-11 Dodano metodę runAccessReport do interfejsu Admin API v1alpha.

Dodaliśmy metodę properties.runAccessReport do wersji v1alpha interfejsu Admin API. Zwraca ona dostosowany raport rekordów dostępu do danych. Raport zawiera rekordy każdego przypadku, gdy użytkownik odczytuje dane do raportu Google Analytics. Raporty o dostępie do danych są dostępne dla administratorów usług Google Analytics 360.

2022-07-11 Udostępniono wersję v1beta interfejsu Admin API.

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

W przypadku interfejsu Admin API nadal obsługujemy kanały alfa 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 po ich dopracowaniu.

2021-10-12 Usunięto z interfejsu API metody EnhancedMeasurementSettings.

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

2021-06-05 Dodano funkcje.

Do interfejsu API dodaliśmy te funkcje:

• accounts.searchChangeHistoryEvents Dodaliśmy do interfejsu API metodę. Ta metoda przeszukuje wszystkie zmiany na koncie lub jego podrzędnych kontach na podstawie określonego zestawu filtrów. Typowe przyczyny to aktualizacje 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 Measurement Protocol w sekcji properties.dataStreams.measurementProtocolSecrets:
  • create – tworzy tajny klucz Measurement Protocol.
  • delete – usuwa docelowy tajny klucz Measurement Protocol.
  • get – wyszukuje pojedynczy tajny klucz Measurement Protocol.
  • list – zwraca podrzędne tajne klucze Measurement Protocol w określonej usłudze nadrzędnej.
  • patch – aktualizuje tajny klucz Measurement Protocol.
• Dodaliśmy 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 – pobiera pojedyncze zdarzenie konwersji.
  • list – zwraca listę zdarzeń konwersji w określonej usłudze nadrzędnej.
• Dodaliśmy metody zarządzania wymiarami niestandardowymi w sekcji properties.customDimensions:
  • archive – archiwizuje wymiar niestandardowy w usłudze.
  • create – tworzy wymiar niestandardowy.
  • get – wyszukuje pojedynczy wymiar niestandardowy.
  • 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 sekcji properties.customMetrics:
  • archive – archiwizuje dane niestandardowe w usłudze.
  • create – tworzy dane niestandardowe.
  • get – wyszukuje pojedyncze dane niestandardowe.
  • list – wyświetla listę danych niestandardowych w usłudze.
  • patch – aktualizuje dane niestandardowe w usłudze.
• Dodaliśmy metody properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings , które umożliwiają kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4.
• delete_time, expire_time Dodaliśmy do typu Property pola tylko do odczytu.

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

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

• Usunęliśmy z interfejsu API metody properties.iosAppDataStreams.create i properties.androidAppDataStreams.create. Aby utworzyć strumienie aplikacji w usłudze w Google Analytics 4, użyj Firebase.
• properties.delete metoda zwraca teraz dane usuniętej usługi jako typ Property zamiast pustej odpowiedzi.
• time_zone pole typu Property jest teraz wymagane.
• Usunęliśmy pole deleted z typu Property.
• email_address pole typu UserLink jest teraz niezmienne.
• name pole typu UserLink jest teraz tylko do odczytu.

2021-01-28 Dodano obsługę stronicowania w przypadku operacji ListFirebaseLinks.

2021-01-28 Zmiany powodujące niezgodność.

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

• Zmieniliśmy nazwę pola country_code na region_code w Account.

• Zmieniliśmy nazwę pola url_query_parameter na uri_query_parameter w EnhancedMeasurementSettings.

• Usunęliśmy pole parent z GoogleAdsLink.

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

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

2020-10-13 Zmieniliśmy nazwę usług Aplikacje + internet na Google Analytics 4 (GA4).

2020-08-15 Zmieniliśmy nazwę interfejsu Management App + Web API na Admin API.

Zmieniliśmy nazwę interfejsu Google Analytics Management App + Web API na Google Analytics Admin API. W związku z tym punkt końcowy interfejsu API zmienił się 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 klienckich.