Historia zmian

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

14 kwietnia 2026 r. Dodano metodę GetUserProvidedDataSettings

2025-08-20 Dodano metodę GetReportingIdentitySettings

Dodano metodę GetReportingIdentitySettings do interfejsu Admin API w wersji alfa 1, 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 kwietnia 2025 r. Dodano metody zarządzania adnotacjami danych raportowania

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

20.01.2025 Dodano informacje o przechowywaniu 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 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 nowej sekcji BIGQUERY_LINKwartość wChangeHistoryResourceType.

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

Zmieniliśmy nazwę metody niestandardowej createSubproperty na provisionSubproperty w interfejsie Admin API w wersji alfa 1, 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 spełnionych 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.

Dodaliśmy 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 ustawienie primary na true. Ustawienie wartości primary w kolumnie true dla grupy kanałów automatycznie ustawia wartość primary w kolumnie false dla poprzedniej głównej grupy kanałów.

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ę API, aby używała metody KeyEvent zamiast metody 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 we wszystkich usługach w Google Analytics, zarówno w wersji Standard, jak i w Google Analytics 360.

Więcej informacji znajdziesz w dokumentacji schematu.

15 grudnia 2023 r. Wymiar accessDateHour został dodany do schematu raportu Dostęp do danych.

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 W usługach z modelami atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji” domyślnym modelem jest 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 modeli „Ostatnie kliknięcie w wielu kanałach” lub „Preferowane ostatnie kliknięcie w Google Ads”.

2023-09-01 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 dodano 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 będą 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 1 alfa

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 Dodaliśmy 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 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. Dodano 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 powinna być używana 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.02.2023 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.

properties.setAutomatedGa4ConfigurationOptOut, properties.fetchAutomatedGa4ConfigurationOptOut 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.

Do wersji v1alpha interfejsu API dodano 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.

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 jednostką 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.

Kanały wersji alfa i beta interfejsu API nadal są obsługiwane w przypadku interfejsu Admin API. 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ęto z interfejsu API metody EnhancedMeasurementSettings.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings metody zostały usunięte z interfejsu API, ale ustawienia pomiarów ulepszonych wkrótce będzie można 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 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 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 elementach 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.webDataStreams.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 API platformy Measurement Protocol w usługach podrzędnych 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ź.
  • time_zone pole 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.01.2021 Zmiany powodujące niezgodność.

Zmiany powodujące niezgodność:update_mask pole 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 Aplikacja do zarządzania + interfejs Web API zostały zmienione na interfejs 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.