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
- Dodaliśmy metodę
UpdateReportingIdentitySettingsdo interfejsu Admin API w wersji v1alpha, co umożliwia aktualizowanieReportingIdentitySettingsw przypadku usługi.
18.06.2026 Dodano pole can_edit do PropertySummary
- Dodano pole
can_editdo zasobuPropertySummaryw 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
Dodaliśmy metodę
GetUserProvidedDataSettingsdo interfejsu Admin API w wersji v1alpha, która umożliwia pobieranieUserProvidedDataSettingsusługi.Do interfejsu Admin API w wersji 1alpha dodaliśmy zasób
UserProvidedDataSettings, który zawiera polauserProvidedDataCollectionEnablediautomaticallyDetectedDataCollectionEnabledzbierania danych przekazywanych przez użytkowników.
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ć.
1 sierpnia 2024 r. Dodano zarządzanie połączeniami z BigQuery.
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.
31.05.2023 Dodaliśmy metody zarządzania połączeniami z AdSense.
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.
24.02.2023 Powiązania dostępu zastępują połączenia użytkowników w zarządzaniu uprawnieniami użytkowników.
Do wersji v1alpha interfejsu API dodano zasób AccessBinding oraz te operacje:
accounts.accessBindings.createaccounts.accessBindings.deleteaccounts.accessBindings.patchaccounts.accessBindings.listaccounts.accessBindings.getaccounts.accessBindings.batchCreateaccounts.accessBindings.batchDeleteaccounts.accessBindings.batchUpdateaccounts.accessBindings.batchGetproperties.accessBindings.createproperties.accessBindings.deleteproperties.accessBindings.patchproperties.accessBindings.listproperties.accessBindings.getproperties.accessBindings.batchCreateproperties.accessBindings.batchDeleteproperties.accessBindings.batchUpdateproperties.accessBindings.batchGet
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.
15.02.2023 Dodano metody zarządzania połączeniami z BigQuery.
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.
15.02.2023 Dodaliśmy metody zarządzania połączeniami z Search Ads 360.
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ść.
Z typu wyliczeniowego
NumericFilter.Operationusunięto wartościLESS_THAN_OR_EQUALiGREATER_THAN_OR_EQUAL.Usunięto wartość
PARTIAL_REGEXPz typu wyliczeniowegoStringFilter.MatchType.
15.02.2023 – różne zmiany.
- Dodano pole
tokensPerProjectPerHourdo typuAccessQuota. - Do typu wyliczeniowego
ChangeHistoryResourceTypedodano wartościEXPANDED_DATA_SET,CHANNEL_GROUP. - Wartości
searchAds360Link,expandedDataSet,bigqueryLinkzostały dodane do:ChangeHistoryResource.
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.getEnhancedMeasurementSettingsiproperties.webDataStreams.updateEnhancedMeasurementSettingszostały usunięte z interfejsu API, ale ustawienia pomiaru zaawansowanego będzie można wkrótce ponownie modyfikować za pomocą interfejsu API. - Pole
directRoleszasobuUserLinknie obsługuje już rolipredefinedRoles/manage-users. Zamiast tego należy użyć nowej rolipredefinedRoles/admin, która jest odpowiednikiem kombinacji starych rólpredefinedRoles/editipredefinedRoles/manage-users. Ta zmiana wpływa na działanie metodaccounts.userLinksiproperties.userLinksoraz 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:createTworzy obiekt tajny Measurement Protocol.deleteUsuwa docelowy obiekt tajny platformy Measurement Protocol.getWyszukiwanie pojedynczego obiektu tajnego platformy Measurement Protocol.listZwraca tajne klucze podrzędne platformy Measurement Protocol w określonej usłudze nadrzędnej.patchAktualizuje obiekt tajny platformy Measurement Protocol.
- Metody zarządzania zdarzeniami konwersji dodane w sekcji
properties.conversionEvents: - Metody zarządzania wymiarami niestandardowymi dodane w
properties.customDimensions: - Metody zarządzania danymi niestandardowymi dodane w
properties.customMetrics: - Dodano metody
properties.getGoogleSignalsSettingsiproperties.updateGoogleSignalsSettings, które umożliwiają kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4. - Do typu
Propertydodano pola tylko do odczytudelete_timeiexpire_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.createiproperties.androidAppDataStreams.create. Aby utworzyć strumienie danych z aplikacji w usłudze w Google Analytics 4, użyj Firebase. - Metoda
properties.deletezwraca teraz usunięte dane właściwości jako typPropertyzamiast pustej odpowiedzi. - Pole
time_zonetypuPropertyjest teraz wymagane. - Pole
deletedzostało usunięte z typuProperty. - Pole
email_addresstypuUserLinkjest teraz niezmienne. - Pole
nametypuUserLinkjest teraz tylko do odczytu.
28.01.2021 Dodano obsługę podziału na strony w przypadku operacji ListFirebaseLinks.
28.01.2021 Zmiany powodujące niezgodność.
Zmiany powodujące niezgodność:
– Pole update_mask jest wymagane we wszystkich operacjach aktualizacji.
Zmieniono nazwę pola
country_codenaregion_codew:Account.Zmieniono nazwę pola
url_query_parameternauri_query_parameterw:EnhancedMeasurementSettings.Pole
parentzostało usunięte z usługiGoogleAdsLink.
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.