Dziennik zmian

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

20.08.2025 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. To pole zostanie usunięte z interfejsu Google Analytics Admin API w wersji 1beta w czerwcu 2025 r.

2025-01-20 Dodano informacje o przechowywaniu danych użytkowników do sekcji DataRetentionSettings

Dodano pole userDataRetention do DataRetentionSettings w interfejsach Admin API w wersjach 1 alfa i 1 beta. 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

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 nowej sekcji BIGQUERY_LINK wartość w ChangeHistoryResourceType.

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 zdefiniować modyfikacje parametrów ze zdarzenia źródłowego.

01.08.2024 Różne zmiany

Dodano create_time do zasobu Audience.

Dodano pole 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 danym momencie 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 wydarzeń.

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

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

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.

2023-09-01 Zmieniliśmy nazwę pola BigQueryLink.enterprise_export_enabled na fresh_daily_export_enabled.

Pole enterprise_export_enabled zasobu BigQueryLink zostało zmienione na fresh_daily_export_enabled.

2023-07-14 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 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.

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

2023-05-31 Dodano 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.

31 marca 2023 r. 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 GA4.

31.03.2023 Dodaliśmy metody zarządzania połączonymi tagami witryny.

Metody properties.createConnectedSiteTag, properties.deleteConnectedSiteTag i properties.listConnectedSiteTags dodane do interfejsu Admin API w wersji alfa 1.

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 dodano 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 z dniem 1 czerwca 2023 r.

24 lutego 2023 r. Wycofanie metod audytu uprawnień użytkownika.

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

24 lutego 2023 r. 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 listami odbiorców w usłudze w GA4.

15 lutego 2023 r. Dodaliśmy metody rezygnacji z procesu automatycznej 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 dodano 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 została dodana do wersji v1alpha interfejsu Admin API. Zwraca dostosowany raport rekordów 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. Kanał 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ęcie z interfejsu API metod 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 przeszukuje 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.webDataStreams.measurementProtocolSecrets:
    • create Tworzy tajny klucz platformy Measurement Protocol.
    • delete Usuwa docelowy klucz tajny platformy Measurement Protocol.
    • get Wyszukiwanie pojedynczego tajnego klucza platformy Measurement Protocol.
    • list Zwraca tajne klucze API platformy Measurement Protocol w usłudze podrzędnej w określonej usłudze nadrzędnej.
    • patch Aktualizuje obiekt tajny 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.
  • Dodaliśmy 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 pola tylko do odczytu dodane do typu Property.

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.01.2021 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 API aplikacji i usługi w internecie do zarządzania został zmieniony 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. Istniejący kod napisany w oparciu o poprzednią wersję adresu URL punktu końcowego interfejsu API i bibliotek klienta wymaga odpowiedniej aktualizacji.