Historia zmian

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

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

Dodano pole userDataRetention do interfejsu DataRetentionSettings w interfejsie Admin API w wersjach 1alpha i 1beta. Za pomocą tego pola możesz pobierać i modyfikować ustawienia przechowywania danych użytkownika.

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

Dokumentacja metody runAccessReport została zaktualizowana i zawiera link do formularza opinii na temat raportów Google Analytics Access. Cenimy Twój wkład i zachęcamy do podzielenia się opinią na temat tego interfejsu API, aby pomóc nam w dalszym ulepszaniu tej usługi.

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.

Dodano zmiany w połączeniu z BigQuery do historii zmian w ramach nowej wartości BIGQUERY_LINK w ChangeHistoryResourceType.

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

W interfejsie Admin API w wersji 1alpha zmieniliśmy nazwę metody niestandardowej createSubproperty na provisionSubproperty, 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 1alpha.

EventEditRule definiuje 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 z źródła zdarzenia.

2024-08-01 Różne zmiany

Do zasobu Audience dodano create_time.

Do zasobu ChannelGroup dodaliśmy parametr primary, który wskazuje, czy grupa kanałów jest domyślną grupą kanałów na potrzeby raportów. W danym momencie tylko 1 grupa kanałów może mieć wartość primary ustawioną na true. Ustawienie wartości primary na true w grupie kanałów powoduje automatyczne ustawienie wartości primary na false w poprzedniej głównej grupie kanałów.

Do zasobu Account dodano element gmp_organization, który zawiera identyfikator 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

Zasoby i metody dotyczące kluczowych wydarzeń są już dostępne.

Zmodyfikuj integrację z interfejsem API, aby używać metody KeyEvent zamiast metody ConversionEvent. Środowisko wykonawcze ConversionEvent zostało wycofane.

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

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

Więcej informacji znajdziesz w dokumentacji schematu.

2023-12-15 Wymiar accessDateHour został dodany do schematu raportu Dostęp do danych.

Wymiar accessDateHour został dodany do schematu raportu Dostęp 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” są domyślnie przełączane na model atrybucji 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 użycia metody UpdateAttributionSettings we wszystkich usługach.

Jeśli Twoja usługa jest obecnie skonfigurowana pod kątem używania jednego z tych modeli, zostanie przełączona na atrybucję opartą na danych w wielu kanałach. Nadal możesz używać modelu Ostatnie kliknięcie w wielu kanałach lub Preferowane ostatnie kliknięcie w Google Ads.

2023-09-01 Dodano 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 danych na iOS.

2023-09-01 Dodano metodę UpdateConversionEvent.

Metoda UpdateConversionEvent została dodana do interfejsu Admin API w wersji 1beta.

2023-09-01 Pole 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.

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

Od 24 lipca 2023 r. wprowadzimy zmiany w wersji alfa interfejsu Admin API 1, które wpłyną na działanie metod properties.getAttributionSettings i properties.updateAttributionSettings.

Wartości z enumeracji ReportingAttributionModel zostaną przemianowane 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

Elementy listy AdsWebConversionDataExportScope zostaną przemianowane w ten sposób:

Stara 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

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. metody UpdateAttributionSettings nie można używać do konfigurowania usług w GA4, które korzystają z 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 oświadczeniu dotyczącym usługi Google Analytics.

GetAdSenseLink, CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinksmetody dodane do interfejsu Admin API w wersji 1alpha.

Ta funkcja umożliwia zarządzanie połączeniami AdSense z Analytics w usłudze w GA4.

2023-05-31 Dodano metodę wyszukiwania połączonej usługi w GA4.

Metoda FetchConnectedGa4Property została dodana do wersji alfa 1 interfejsu Admin API.

Ta funkcja umożliwia uzyskanie informacji o usłudze w GA4 połączonej z Twoją usługą w Universal Analytics podczas procesu migracji do GA4.

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

Do interfejsu Admin API w wersji 1alpha dodano metody CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules i GetEventCreateRule.

Ta funkcja umożliwia zarządzanie regułami tworzenia zdarzeń, które mogą uruchamiać tworzenie zupełnie nowych zdarzeń 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 w przypadku źródeł wizyt w Twojej witrynie.

Po utworzeniu niestandardowych grup kanałów możesz wysyłać zapytania do nich za pomocą interfejsu Google Analytics Data API w wersji 1.

31 marca 2023 r. Dodano metody zarządzania ustawieniami pomiaru zaawansowanego.

Metody properties.dataStreams.updateEnhancedMeasurementSettings i properties.dataStreams.getEnhancedMeasurementSettings zostały dodane do interfejsu Admin API w wersji 1alpha.

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

2023-03-31 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.

2023-03-31 Dodaliśmy do interfejsu Admin API w wersji 1beta metody runAccessReport na poziomie konta i usługi.

Dodano metody properties.runAccessReport i accounts.runAccessReport do wersji v1beta interfejsu Admin API. Metody zwracają niestandardowy raport z danymi o dostępie do danych.

2023-02-24 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. Możesz z niej korzystać do zarządzania rozwiniętymi zbiorami danych w Google Analytics 360.

Do wersji v1alpha interfejsu API dodano zasób AccessBinding oraz te operacje:

Ta funkcja umożliwia zarządzanie uprawnieniami użytkowników na koncie lub w usłudze GA4 i powinna być używana zamiast połączeń z użytkownikiem.

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

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

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

2023-02-24 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.

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

Do wersji v1alpha interfejsu API dodano operacje properties.setAutomatedGa4ConfigurationOptOut i properties.fetchAutomatedGa4ConfigurationOptOut.

Ta funkcja umożliwia zarządzanie stanem rezygnacji z automatycznego procesu konfiguracji GA4 w usłudze w UA.

Do wersji v1alpha interfejsu API dodano zasób BigQueryLink oraz odpowiadające mu 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.

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ą GA4 a elementem Search Ads 360.

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

2023-02-15 Różne zmiany.

2022-08-11 Dodano metodę runAccessReport do interfejsu Admin API w wersji 1alpha.

Metoda properties.runAccessReport została dodana do wersji v1alpha interfejsu Admin API. Zwraca on niestandardowy raport z rekordami dostępu do danych. Raport zawiera zapisy dotyczące każdego przypadku, gdy użytkownik odczytał dane do raportu Google Analytics. Raporty dostępu do danych są dostępne dla administratorów usług w Google Analytics 360.

2022-07-11 Wprowadziliśmy wersję beta interfejsu Admin API w wersji 1.

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

W przypadku interfejsu Admin API nadal obsługiwane są kanały wersji alfa i beta. Kanał beta zawiera podzbiór funkcji dostępnych w wersji alpha, które są stabilne i nie powinny ulec znacznym zmianom w przyszłości. Nowe funkcje będą dodawane do wersji beta, gdy będą gotowe.

12 października 2021 r. Usunięto z interfejsu API metody EnhancedMeasurementSettings.

  • Metody properties.webDataStreams.getEnhancedMeasurementSettings i properties.webDataStreams.updateEnhancedMeasurementSettings zostały usunięte z interfejsu API, ale ustawienia rozszerzonego pomiaru wkrótce będzie można znowu modyfikować za pomocą interfejsu API.
  • Pole directRoles zasobu UserLink nie obsługuje już roli predefinedRoles/manage-users. Zamiast tego należy użyć 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, a także 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 elementach podrzędnych na podstawie określonego zestawu filtrów. Typowymi przyczynami są aktualizacje wprowadzone w interfejsie Google Analytics, zmiany wprowadzone przez obsługę klienta lub automatyczne zmiany w systemie Google Analytics.
  • Dodano metody zarządzania tajnymi kluczami platformy Measurement Protocol:properties.webDataStreams.measurementProtocolSecrets:
    • createTworzy obiekt tajny platformy Measurement Protocol.
    • delete Usuwanie tajnego obiektu Measurement Protocol docelowego.
    • get Wyszukiwanie pojedynczego tajnego klucza platformy Measurement Protocol.
    • list Zwraca tajne klucze usługi podrzędnej w usłudze nadrzędnej.
    • patch Zmienia tajny klucz Measurement Protocol.
  • Dodano metody zarządzania zdarzeniami konwersji w sekcji properties.conversionEvents:
    • createTworzy zdarzenie konwersji ze wskazanymi atrybutami.
    • delete Usuwanie zdarzenia konwersji w usłudze.
    • get Pobieranie pojedynczego zdarzenia konwersji.
    • listZwraca listę zdarzeń konwersji w wybranej usłudze nadrzędnej.
  • Dodano metody zarządzania wymiarami niestandardowymi w sekcji properties.customDimensions:
    • archive Archiwizowanie wymiaru niestandardowego w usłudze.
    • createTworzy wymiar niestandardowy.
    • getWyszukiwanie pojedynczego wymiaru niestandardowego.
    • list Wypisuje wymiary niestandardowe w usłudze.
    • patchZmienia wymiar niestandardowy w usłudze.
  • Dodano metody zarządzania danymi niestandardowymi w sekcji properties.customMetrics:
    • archive Archiwizowanie danych niestandardowych w usłudze.
    • createtworzy dane niestandardowe.
    • getWyszukiwanie pojedynczych danych niestandardowych.
    • list Wypisuje dane niestandardowe usługi.
    • patch Zmienia dane niestandardowe w usłudze.
  • Dodano metody properties.getGoogleSignalsSettings i properties.updateGoogleSignalsSettings, które umożliwiają kontrolowanie ustawienia Google Signals w usłudze w Google Analytics 4.
  • delete_time, expire_time pola wyjściowe dodane do typu Property.

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

Wprowadziliśmy następujące zmiany:

  • Z interfejsu API usunięto metody properties.iosAppDataStreams.create i properties.androidAppDataStreams.create. Aby tworzyć strumienie danych aplikacji w usłudze w Google Analytics 4, użyj Firebase.
  • Metoda properties.delete zwraca teraz dane usuniętej właściwości jako typ Property zamiast pustej odpowiedzi.
  • Pole time_zone typu Property jest teraz wymagane.
  • Usunięto pole deleted z typu Property.
  • Pola email_address typu UserLink nie można już zmieniać.
  • Pole name typu UserLink jest teraz tylko wyjściowe.

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

Zmiany powodujące przerwanie działania: – pole update_mask jest wymagane we wszystkich operacjach aktualizacji.

  • Zmieniono nazwę pola country_code na region_code w Account.

  • Zmieniono nazwę pola url_query_parameter na uri_query_parameter w EnhancedMeasurementSettings.

  • Pole parent zostało usunięte z grupy GoogleAdsLink.

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

Dodano obsługę metody podsumowania konta.

2020-10-13 Usługi Aplikacje + internet zostały przemianowane na Google Analytics 4 (GA4).

15 sierpnia 2020 r. Zmiana nazwy interfejsu API aplikacji do zarządzania i interfejsu API w sieci na interfejs API administracyjny.

Interfejs API zarządzania usługami Aplikacje + internet w Google Analytics został przemianowany na interfejs API administracji Google Analytics. W rezultacie punkt końcowy interfejsu API zmienił się na analyticsadmin.googleapis.com. Istniejący kod napisany z użyciem poprzedniej wersji adresu URL punktu końcowego interfejsu API i bibliotek klienta musi zostać odpowiednio zaktualizowany.