Aby otrzymywać oficjalne ogłoszenia o interfejsie API Google Analytics, zasubskrybuj grupę powiadomień o interfejsie Google Analytics API.
15.12.2023 Raporty o dostępie do danych są teraz dostępne we wszystkich usługach w Google Analytics.
Niektóre pola funkcji Raporty o dostępie do danych są teraz dostępne we wszystkich usługach w Google Analytics, zarówno w przypadku klientów standardowych, jak i klientów Google Analytics 360.
Więcej informacji znajdziesz w dokumentacji schematu.
15.12.2023 – wymiar accessDateHour
został dodany do schematu raportu Dostęp do danych.
Wymiar accessDateHour
został dodany do schematu raportu o dostępie do danych. Zawiera on godzinę, kiedy użytkownik Google Analytics uzyskał dostęp do danych raportowania Google Analytics.
5.10.2023 r. W przypadku usług z modelami atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji” domyślnie wybrana jest atrybucja oparta na danych w wielu kanałach.
Od połowy października 2023 r. modeli atrybucji Pierwsze kliknięcie, Liniowy, Spadek udziału z upływem czasu i Uwzględnienie pozycji nie będzie można używać z metodą UpdateAttributionSettings w przypadku wszystkich usług.
Jeśli Twoja usługa jest obecnie skonfigurowana do używania jednego z tych modeli, zostanie zmieniona na atrybucję opartą na danych obejmującą różne kanały. Nadal będziesz mieć możliwość wyboru modelu „Ostatnie kliknięcie w wielu kanałach” lub „Preferowane ostatnie kliknięcie w Google Ads”.
1.09.2023 r. dodano metody konfiguracji schematu wartości konwersji SKAdNetwork.
GetSKAdNetworkConversionValueSchema
,
CreateSKAdNetworkConversionValueSchema
,
DeleteSKAdNetworkConversionValueSchema
,
UpdateSKAdNetworkConversionValueSchema
,
ListSKAdNetworkConversionValueSchemas
dodano do interfejsu Admin API w wersji 1alfa.
Ta funkcja pozwala zarządzać konfiguracją schematu wartości konwersji SKAdNetwork w przypadku strumienia iOS.
1.09.2023 r. dodano metodę UpdateConversionEvent
.
Metoda UpdateConversionEvent
została dodana do wersji beta interfejsu Admin API.
1.09.2023 r. zmieniono nazwę pola BigQueryLink.enterprise_export_enabled
na fresh_daily_export_enabled
.
Nazwa pola enterprise_export_enabled
zasobu BigQueryLink
została zmieniona na fresh_daily_export_enabled
.
14.07.2023 r. Zmiany dotyczące metod properties.updateAttributionSettings
, properties.getAttributionSettings
.
Od 24 lipca 2023 r. w interfejsie Admin API w wersji 1 będą wprowadzane zmiany powodujące niezgodność, które będą miały wpływ na działanie metod properties.getAttributionSettings i properties.updateAttributionSettings.
Nazwy użytkowników listy ReportingAttributionModel
zostaną zmienione w następujący 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 użytkowników listy AdsWebConversionDataExportScope
zostaną zmienione w następujący sposób:
Stara nazwa | Nowa nazwa |
---|---|
CROSS_CHANNEL |
PAID_AND_ORGANIC_CHANNELS |
ADS_PREFERRED |
GOOGLE_PAID_CHANNELS |
10.07.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óry można modyfikować za pomocą metody UpdateAttributionSettings
.
5.06.2023 r. Wycofanie modeli atrybucji „Pierwsze kliknięcie”, „Liniowy”, „Spadek udziału z upływem czasu” i „Uwzględnienie pozycji”.
Od czerwca 2023 r. metody UpdateAttributionSettings nie można używać 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 staną się niedostępne w przypadku niektórych usług.
Więcej informacji znajdziesz w ogłoszeniu o usłudze Google Analytics.
31.05.2023 r. dodaliśmy metody zarządzania połączeniami z AdSense.
Metody GetAdSenseLink
, CreateAdSenseLink
, DeleteAdSenseLink
, ListAdSenseLinks
zostały dodane do interfejsu Admin API w wersji 1alfa.
Ta funkcja pozwala zarządzać połączeniami AdSense i Analytics w usłudze w GA4.
31.05.2023 r. dodaliśmy metodę wyszukiwania połączonej usługi w GA4.
Metoda FetchConnectedGa4Property
dodana do interfejsu Admin API w wersji 1alfa
Ta funkcja pozwala uzyskać informacje o usłudze w GA4 połączonej z usługą w Universal Analytics w trakcie procesu migracji do GA4.
31 maja 2023 r. Dodaliśmy metodę zarządzania regułami tworzenia zdarzeń.
Metody CreateEventCreateRule
,
UpdateEventCreateRule
,
DeleteEventCreateRule
,
ListEventCreateRules
,
GetEventCreateRule
dodane do interfejsu Admin API w wersji 1alfa.
Ta funkcja pozwala zarządzać regułami tworzenia zdarzeń, które mogą uruchamiać tworzenie zupełnie nowego zdarzenia na podstawie spełniających kryteria zdarzenia źródłowego.
31.05.2023 r. dodaliśmy metody zarządzania niestandardowymi grupami kanałów.
Dodano metody GetChannelGroup
,
ListChannelGroups
,
CreateChannelGroup
,
UpdateChannelGroup
,
DeleteChannelGroup
do interfejsu Admin API w wersji 1alfa.
Ta funkcja pozwala zarządzać niestandardowymi grupami kanałów na potrzeby źródeł wizyt w witrynie.
Po utworzeniu niestandardowych grup kanałów można wysyłać zapytania za pomocą interfejsu Google Analytics Data API w wersji 1.
31.03.2023 r. dodaliśmy metody zarządzania Ustawienia pomiaru zaawansowanego.
Metody properties.dataStreams.updateEnhancedMeasurementSettings
i properties.dataStreams.getEnhancedMeasurementSettings
dodane do interfejsu Admin API w wersji 1alfa.
Ta funkcja pozwala zarządzać ustawieniami pomiaru zaawansowanego w przypadku strumienia danych z sieci w usłudze w GA4.
31.03.2023 r. dodano metody zarządzania połączonymi tagami witryny.
Metody properties.createConnectedSiteTag
, properties.deleteConnectedSiteTag
i properties.listConnectedSiteTags
dodane do interfejsu Admin API w wersji 1alfa.
Ta funkcja umożliwia zarządzanie połączonymi tagami witryny i przydaje się do przekierowania ruchu z usługi Universal Analytics do usługi Google Analytics 4.
31.03.2023 Do wersji beta interfejsu Admin API w wersji 1 beta dodaliśmy metody runAccessReport
na poziomie konta i usługi.
Metody properties.runAccessReport
i accounts.runAccessReport
dodane do wersji v1beta interfejsu Admin API. Metody zwracają niestandardowy raport rekordów dostępu do danych.
24.02.2023 r. dodano metody zarządzania zbiorami danych.
Zasób ExpandedDataSet
został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.expandedDataSets.create
, properties.expandedDataSets.delete
, properties.expandedDataSets.patch
, properties.expandedDataSets.list
, properties.expandedDataSets.get
. Ta funkcja może służyć do zarządzania rozwiniętymi zbiorami danych w Google Analytics 360.
24.02.2023 Powiązania dostępu zastępują linki użytkowników na potrzeby zarządzania uprawnieniami użytkowników.
Zasób AccessBinding
został dodany 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 pozwala zarządzać uprawnieniami użytkowników na koncie lub w usłudze GA4 i powinna być używana zamiast połączeń użytkowników.
1 czerwca 2023 r. funkcja Linki użytkowników zostanie usunięta z interfejsu Admin API w wersji 1 w wersji alfa
24.02.2023 r. Wycofujemy metody kontroli uprawnień użytkowników.
Te metody zostały wycofane i 1 czerwca 2023 r. zostaną usunięte z wersji alfa interfejsu Admin API:
24.02.2023 – dodano metody zarządzania odbiorcami.
Zasób Audience
został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.audience.create
, properties.audience.archive
, properties.audience.patch
, properties.audience.list
, properties.audience.get
.
Ta funkcja pozwala zarządzać listami odbiorców w usłudze w GA4.
15.02.2023 r. dodaliśmy metody rezygnacji w automatycznym procesie konfiguracji GA4.
Do wersji v1alpha interfejsu API dodano operacje properties.setAutomatedGa4ConfigurationOptOut
, properties.fetchAutomatedGa4ConfigurationOptOut
.
Ta funkcja pozwala zarządzać stanem rezygnacji w ramach zautomatyzowanego procesu konfiguracji GA4 w usłudze w UA.
15.02.2023 r. dodano metody zarządzania połączeniami z BigQuery.
Zasób BigQueryLink
został dodany do wersji v1alpha interfejsu API wraz z odpowiednimi operacjami properties.bigQueryLinks.get
i properties.bigQueryLinks.list
.
Ta funkcja pozwala pobierać informacje o połączeniach między usługą w GA4 a projektem BigQuery.
15.02.2023 r. dodano metody zarządzania połączeniami z Search Ads 360.
Zasób SearchAds360Link
został dodany do wersji v1alpha interfejsu API wraz z odpowiadającymi im operacjami properties.searchAds360Links.create
, properties.searchAds360Links.delete
, properties.searchAds360Links.patch
, properties.searchAds360Links.list
, properties.searchAds360Links.get
.
Ta funkcja pozwala zarządzać połączeniami między usługą GA4 a elementem Search Ads 360.
15.02.2023 r. Najistotniejsze zmiany.
LESS_THAN_OR_EQUAL
, usunięto wartościGREATER_THAN_OR_EQUAL
z wyliczeniaNumericFilter.Operation
.Z wyliczenia
StringFilter.MatchType
usunięto wartośćPARTIAL_REGEXP
.
15.02.2023 r. Inne zmiany.
- Do typu
AccessQuota
dodano poletokensPerProjectPerHour
. EXPANDED_DATA_SET
, wartościCHANNEL_GROUP
zostały dodane do wyliczeniaChangeHistoryResourceType
.- Dodano wartości
searchAds360Link
,expandedDataSet
,bigqueryLink
doChangeHistoryResource
.
11.08.2022 r. została dodana do wersji 1alfa interfejsu Admin API metoda runAccessReport
.
Metoda properties.runAccessReport
dodana do wersji v1alpha interfejsu Admin API. Zwraca niestandardowy raport rekordów dostępu do danych. Raport zawiera zapis każdego odczytu przez użytkownika danych raportowania Google Analytics. Raporty o dostępie do danych są dostępne dla administratorów usług w Google Analytics 360.
11.07.2022 r. opublikowano wersję beta interfejsu Admin API.
Udostępniliśmy wersję beta interfejsu Google Analytics Admin API.
Zarówno kanał alfa, jak i beta interfejsu API jest nadal obsługiwany przez interfejs Admin API. Wersja beta zawiera podzbiór funkcji dostępnych w wersji alfa, które są uważane za stabilne i w przyszłości nie powinny podlegać znaczącej zmianie. Nowe funkcje będą dodawane do wersji beta w chwili ich dojrzewania.
12.10.2021 – usunięto z API metody EnhancedMeasurementSettings.
properties.webDataStreams.getEnhancedMeasurementSettings
, metodyproperties.webDataStreams.updateEnhancedMeasurementSettings
zostały usunięte z interfejsu API, ale wkrótce będzie można ponownie modyfikować ustawienia pomiaru zaawansowanego za pomocą interfejsu API.- Pole
directRoles
zasobuUserLink
nie obsługuje już rolipredefinedRoles/manage-users
. Zamiast niej należy użyć nowej rolipredefinedRoles/admin
, która jest odpowiednikiem kombinacji starych rólpredefinedRoles/edit
ipredefinedRoles/manage-users
. Ta zmiana wpływa na działanie metodaccounts.userLinks
iproperties.userLinks
oraz jest zgodna ze zmianami dotyczącymi zarządzania dostępem i ograniczeniami dotyczącymi danych wprowadzonych w Google Analytics.
5.06.2021 r. Dodano funkcje.
Do interfejsu API dodane są te funkcje:
- Do interfejsu API dodano metodę
accounts.searchChangeHistoryEvents
. Ta metoda przeszukuje wszystkie zmiany na koncie lub jego kontach podrzędnych z uwzględnieniem określonego zestawu filtrów. Typowe przyczyny to zmiany wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez obsługę klienta lub automatyczne zmiany w systemie Google Analytics. - Metody zarządzania obiektami tajnymi platformy Measurement Protocol dodane w sekcji
properties.webDataStreams.measurementProtocolSecrets
:create
Tworzy obiekt tajny platformy Measurement Protocol.delete
Usuwa obiekt tajny platformy Measurement Protocol.get
Wyszukuje pojedynczy tajny klucz platformy Measurement Protocol.list
Zwraca tajne klucze podrzędne platformy Measurement Protocol w określonej usłudze nadrzędnej.patch
Aktualizuje tajny klucz platformy Measurement Protocol.
- Metody zarządzania zdarzeniami konwersji dodane w sekcji
properties.conversionEvents
: - Metody zarządzania wymiarami niestandardowymi dodane w sekcji
properties.customDimensions
: - Metody zarządzania danymi niestandardowymi dodane w sekcji
properties.customMetrics
: - Dodano metody
properties.getGoogleSignalsSettings
iproperties.updateGoogleSignalsSettings
, które umożliwiają kontrolowanie ustawienia Google Signals w przypadku usługi Google Analytics 4. delete_time
,expire_time
– tylko pola danych wyjściowych dodane do typuProperty
.
5.06.2021 r. Ważne zmiany.
Wprowadziliśmy te zmiany powodujące niezgodność:
properties.iosAppDataStreams.create
, usunięto z interfejsu APIproperties.androidAppDataStreams.create
metody. Użyj Firebase, aby utworzyć strumienie aplikacji w usłudze Google Analytics 4.- Zamiast zwracać pustą odpowiedź, metoda
properties.delete
zwraca teraz usunięte dane usługi jako typProperty
. - Pole
time_zone
typuProperty
jest teraz wymagane. - Z typu
Property
usunięto poledeleted
. email_address
typuUserLink
jest teraz stałe.name
typuUserLink
jest teraz tylko dane wyjściowe.
28.01.2021 Dodano obsługę podziału na strony w operacji ListFirebaseLinks
.
28.01.2021 Ważne zmiany.
Zmiany powodujące niezgodność: – pole update_mask
jest wymagane w przypadku wszystkich operacji aktualizowania.
Nazwa pola
country_code
została zmieniona naregion_code
wAccount
.Nazwa pola
url_query_parameter
została zmieniona nauri_query_parameter
wEnhancedMeasurementSettings
.Pole
parent
zostało usunięte zGoogleAdsLink
.
20.10.2020 Dodaliśmy obsługę podsumowań kont.
Dodaliśmy obsługę metody podsumowań kont.
13.10.2020 r.: usługi Aplikacje + internet zostały zmienione na Google Analytics 4 (GA4).
15.08.2020 – interfejs Management App + Web API zmienił nazwę na Admin API.
Interfejs Google Analytics Management Aplikacje + internet API to teraz Google Analytics Admin API. Z tego powodu punkt końcowy interfejsu API zmienił się na analyticsadmin.googleapis.com. Istniejący kod napisany na podstawie poprzedniej wersji adresu URL punktu końcowego interfejsu API oraz biblioteki klienta muszą zostać odpowiednio zaktualizowane.