Historia zmian

Aby otrzymywać oficjalne komunikaty dotyczące interfejsu Google Analytics API, subskrybuj Interfejs Google Analytics API – Powiadom grupę.

Formularz ankiety na temat raportów dotyczących dostępu (2024-09-09)

Dokumentacja usługi runAccessReport Metoda została zaktualizowana, aby zawierała link do Opinia na temat raportów o dostępie do Google Analytics formularza. Twoja opinia jest dla nas ważna i zachęcamy do podzielenia się nią API, które pomogą nam ją ulepszyć.

Dodano CreateBigQueryLink, UpdateBigQueryLink i DeleteBigQueryLink metody zarządzania BigQueryLink materiałów z interfejsu Admin API v1alfa.

Do zasobu BigQueryLink dodano pole dataset_location.

Do historii zmian dodano zmiany połączenia z BigQuery w nowej wersji BIGQUERY_LINK wartość w argumencie ChangeHistoryResourceType

1.08.2024 Niezbędna zmiana w metodzie createSubproperty

Zmieniono nazwę metody niestandardowej createSubproperty na provisionSubproperty. w interfejsie Admin API w wersji 1alfa, aby dostosować go do metody niestandardowej .

1.08.2024 Dodano zarządzanie regułami edycji zdarzeń

GetEventEditRule CreateEventEditRule, DeleteEventEditRule, ListEventEditRules, UpdateEventEditRules, ReorderEventEditRules, dodanych do interfejsu Admin API w wersji 1alfa.

EventEditRule określa warunki, które spowodują utworzenie zupełnie nowe zdarzenie na podstawie kryteriów zdarzenia źródłowego. Ponadto: element EventEditRule może definiować modyfikacje parametrów ze źródła .

1.08.2024 Inne zmiany

Element create_time został dodany do Audience.

Do zasobu ChannelGroup dodaliśmy parametr primary, aby wskazywać, czy grupa kanałów jest domyślną grupą kanałów na potrzeby raportów. Tylko jedna W grupie kanałów parametr primary może być w dowolnym momencie ustawiony na true. Ustawienie Ustawienie primary na true w przypadku grupy kanałów automatycznie ustawia wartość primary na false dla poprzedniej głównej grupy kanałów.

Element gmp_organization został dodany do: Account zasób, który zawiera identyfikator URI organizacji w Google Marketing Platform jeśli konto jest połączone z organizacją GMP.

6.05.2024 Dodane metody zarządzania kluczowymi zdarzeniami

Zasoby i metody związane z kluczem wydarzeń jest już dostępna.

Zmodyfikuj integrację interfejsu API, aby umożliwić korzystanie z KeyEvent zamiast ConversionEvent Interfejs ConversionEvent został wycofany.

15.12.2023 r. Raporty dostępu do danych są teraz dostępne we wszystkich usługach w Google Analytics.

W niektórych polach funkcji Raporty dostępu do danych są teraz dostępne we wszystkich usługach w Google Analytics, zarówno w wersji standardowej, i Google Analytics 360.

Więcej informacji znajdziesz w dokumentacji schematu.

15.12.2023 – do schematu raportu Dostęp do danych dodano wymiar accessDateHour.

Wymiar accessDateHour został dodany do Schemat raportu o dostępie do danych. Zawiera datę i godzinę użytkownika Google Analytics, który uzyskał dostęp do danych raportowania

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 atrybucji opartej na danych w wielu kanałach.

Od połowy października 2023 r. pierwsze kliknięcie liniowy, Spadek udziału z upływem czasu i Uwzględnienie pozycji nie będzie można używać modeli atrybucji w UpdateAttributionSettings dla wszystkich właściwości.

Jeśli Twoja usługa jest obecnie skonfigurowana do korzystania z jednego z tych modeli, zmieni się na atrybucji opartej na danych obejmującej wiele kanałów. Dalej będziesz mieć dostęp do opcje użycia opcji Ostatnie kliknięcie w wielu kanałach lub Preferowane ostatnie w Google Ads kliknij.

1 września 2023 r. Dodano metody konfiguracji schematu wartości konwersji SKAdNetwork.

GetSKAdNetworkConversionValueSchema CreateSKAdNetworkConversionValueSchema, DeleteSKAdNetworkConversionValueSchema, UpdateSKAdNetworkConversionValueSchema, ListSKAdNetworkConversionValueSchemas. dodanych do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać schematem wartości konwersji SKAdNetwork w przypadku strumienia iOS.

1 września 2023 r. Dodano metodę UpdateConversionEvent.

UpdateConversionEvent dodana do interfejsu Admin API w wersji 1beta.

Nazwa pola BigQueryLink.enterprise_export_enabled 2023-09-01 została zmieniona na fresh_daily_export_enabled.

Nazwa pola enterprise_export_enabled zasobu BigQueryLink została zmieniona na fresh_daily_export_enabled.

14 lipca 2023 r. Zmiany w metodach properties.updateAttributionSettings i properties.getAttributionSettings.

Od 24 lipca 2023 roku w interfejsie Admin API w wersji 1 zostaną wprowadzone zmiany powodujące niezgodność alfa, co wpłynie na funkcjonalność properties.getAttributionSettings, properties.updateAttributionSettings .

Członkowie ReportingAttributionModel enum zostanie 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

Członkowie AdsWebConversionDataExportScope enum zostanie zmienione w ten sposób:

Stara nazwa Nowa nazwa
CROSS_CHANNEL PAID_AND_ORGANIC_CHANNELS
ADS_PREFERRED GOOGLE_PAID_CHANNELS

10.07.2023 Do typu AttributionSettings dodano pole ads_web_conversion_data_export_scope

Pole ads_web_conversion_data_export_scope zostało dodane do sekcji AttributionSettings, który można modyfikować za pomocą 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. funkcja UpdateAttributionSettings nie można jej używać do konfigurowania usług GA4 z atrybutem pierwsze kliknięcie, liniowy, Spadek udziału z upływem czasu i uwzględnianie pozycji modeli atrybucji. We wrześniu 2023 r. zastąpimy te modele niedostępne w przypadku wszystkich usług.

Zapoznaj się z ogłoszeniem dotyczącym usługi Google Analytics. .

GetAdSenseLink CreateAdSenseLink, DeleteAdSenseLink, ListAdSenseLinks dodanych do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać połączeniami AdSense z Analytics. dla usługi w GA4.

31.05.2023 r. dodaliśmy metodę wyszukiwania połączonej usługi w GA4.

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

Ta funkcja pozwala uzyskać informacje o Usługa w GA4 połączona z usługą w Universal Analytics podczas migracji do GA4.

31.05.2023 r. Dodano metodę zarządzania regułami tworzenia wydarzeń.

CreateEventCreateRule, UpdateEventCreateRule, DeleteEventCreateRule, ListEventCreateRules, GetEventCreateRule dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać reguły tworzenia zdarzeń które mogą powodować utworzenie zupełnie nowego zdarzenia na podstawie dopasowania kryterium zdarzenia źródłowego.

2023-05-31 Dodano metody zarządzania niestandardowymi grupami kanałów.

Dodano: GetChannelGroup, ListChannelGroups, CreateChannelGroup, UpdateChannelGroup, DeleteChannelGroup. do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać niestandardowe grupy kanałów dla źródeł wizyt w witrynie.

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

2023-03-31 Dodano metody zarządzania ustawieniami 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, properties.listConnectedSiteTags dodane do interfejsu Admin API w wersji 1alfa.

Ta funkcja pozwala zarządzać połączonymi tagami witryny i przydaje się do przekierowania ruchu z usługi w Universal Analytics do usługi w Google Analytics 4.

31.03.2023 r. Do interfejsu Admin API w wersji 1beta dodaliśmy metody runAccessReport na poziomie konta i usługi.

properties.runAccessReport i accounts.runAccessReport dodanych do wersji v1beta interfejsu Admin API. Metody zwracają błąd dostosowany raport rekordów dostępu do danych.

24.02.2023 r.: dodano metody zarządzania zbiorami danych w wersji rozszerzonej.

ExpandedDataSet zasób został dodany do wersji v1alpha interfejsu API wraz z odpowiednim properties.expandedDataSets.create, properties.expandedDataSets.delete, properties.expandedDataSets.patch, properties.expandedDataSets.list properties.expandedDataSets.get operacji. Tej funkcji możesz używać do zarządzania rozwiniętymi zbiorami danych w Google Analytics 360.

AccessBinding zasób został dodany do wersji v1alpha interfejsu API wraz z następujące operacje:

Ta funkcja pozwala zarządzać uprawnieniami użytkowników na koncie GA4 lub i należy jej używać zamiast linków użytkowników.

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

24.02.2023 – wycofanie metod kontroli uprawnień użytkowników.

Poniższe metody zostały wycofane i zostaną usunięte z interfejsu Admin API w wersji 1 alfa 1.06.2023:

2023-02-24 Dodano metody zarządzania odbiorcami.

Audience zasób został dodany do wersji v1alpha interfejsu API wraz z odpowiednim properties.audience.create, properties.audience.archive, properties.audience.patch, properties.audience.list properties.audience.get operacji.

Ta funkcja pozwala zarządzać listami odbiorców usługi w GA4.

15 lutego 2023 r. Dodaliśmy metody rezygnacji w automatycznym procesie konfiguracji GA4.

properties.setAutomatedGa4ConfigurationOptOut Operacje properties.fetchAutomatedGa4ConfigurationOptOut zostały dodane do wersji v1alpha interfejsu API.

Ta funkcja pozwala zarządzać stanem rezygnacji w przypadku zautomatyzowanej GA4 proces konfiguracji w usłudze w UA.

BigQueryLink zasób został dodany do wersji v1alpha interfejsu API wraz z odpowiednie properties.bigQueryLinks.get, properties.bigQueryLinks.list operacji.

Ta funkcja umożliwia pobieranie informacji o połączeń między usługą w GA4 a projektem BigQuery,

SearchAds360Link zasób został dodany do wersji v1alpha interfejsu API wraz z odpowiednim properties.searchAds360Links.create, properties.searchAds360Links.delete, properties.searchAds360Links.patch, properties.searchAds360Links.list properties.searchAds360Links.get operacji.

Ta funkcja pozwala zarządzać połączeniami między usługą w GA4 elementu Search Ads 360.

15.02.2023 Zmiany.

15 lutego 2023 r. Różne zmiany.

Metoda runAccessReport 11.08.2022 została dodana do interfejsu Admin API w wersji 1alfa.

properties.runAccessReport została dodana do wersji v1alpha interfejsu Admin API. Zwraca ono błąd dostosowany raport rekordów dostępu do danych; Raport zawiera zapis każdego za każdym razem, gdy użytkownik odczytuje dane raportowania Google Analytics. Raporty dostępu do danych są dostępna dla administratorów usług w Google Analytics 360.

11.07.2022 Udostępniliśmy wersję beta interfejsu Admin API.

Wersja v1beta interfejsu Google Analytics Admin API.

Administratorzy mogą nadal obsługiwać zarówno kanały alfa, jak i beta interfejsu API. API. Wersja beta obejmuje podzbiór funkcji dostępnych w wersji alfa, są uznawane za stabilne i nie powinny znacząco zmienić w przyszłości. Nowe funkcje będą dodawane do wersji beta, gdy będą one dla dorosłych.

12.10.2021 usunięto z interfejsu API metody EnhancedMeasurementSettings.

  • properties.webDataStreams.getEnhancedMeasurementSettings, properties.webDataStreams.updateEnhancedMeasurementSettings metody nie są usunięte z interfejsu API, ale pomiar zaawansowany wkrótce będzie można znowu modyfikować ustawienia za pomocą interfejsu API.
  • Pole directRoles obiektu UserLink zasób nie obsługuje już roli predefinedRoles/manage-users. Zamiast niej należy użyć nowej roli predefinedRoles/admin, która jest odpowiednik starej kombinacji predefinedRoles/edit i Role: predefinedRoles/manage-users. Ta zmiana wpływa na działanie accounts.userLinks properties.userLinks oraz jest zgodne z zarządzaniem dostępem i ograniczeniami dotyczącymi danych. wprowadzonych w Google Analytics.

5.06.2021 Dodano funkcje.

Do interfejsu API dodawane są te funkcje:

  • accounts.searchChangeHistoryEvents została dodana do interfejsu API. Ta metoda przeszukuje wszystkie zmiany w konta lub jego elementów podrzędnych przy użyciu określonego zestawu filtrów. Najczęstsze przyczyny w interfejsie Google Analytics, zmiany wprowadzone przez klienta pomocy technicznej i automatycznych zmian w systemie Google Analytics.
  • Metody zarządzania obiektami tajnymi platformy Measurement Protocol dodane w properties.webDataStreams.measurementProtocolSecrets:
    • create Tworzy obiekt tajny protokołu Measurement Protocol.
    • delete Usuwa obiekt tajny docelowego protokołu Measurement Protocol.
    • get Wyszukiwanie jednego obiektu tajnego na platformie Measurement Protocol.
    • list Zwraca podrzędne obiekty tajne protokołu Measurement Protocol w określonej usłudze nadrzędnej.
    • patch Aktualizuje obiekt tajny platformy Measurement Protocol.
  • Metody zarządzania zdarzeniami konwersji dodane na koncie properties.conversionEvents:
    • create Tworzy zdarzenie konwersji o określonych atrybutach.
    • delete Usuwa z usługi zdarzenie konwersji.
    • get Pobierz pojedyncze zdarzenie konwersji.
    • list Zwraca listę zdarzeń konwersji w podanej usłudze nadrzędnej.
  • Metody zarządzania wymiarami niestandardowymi dodane 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 związanych z usługą.
    • patch Aktualizuje wymiar niestandardowy w usłudze.
  • Niestandardowe metody zarządzania danymi dodane w sekcji properties.customMetrics:
    • archive Archiwizuje dane niestandardowe w usłudze.
    • create Generuje dane niestandardowe.
    • get Wyszukiwanie pojedynczych danych niestandardowych.
    • list Wyświetla listę danych niestandardowych w usłudze.
    • patch Aktualizuje dane niestandardowe w usłudze.
  • Dodano: properties.getGoogleSignalsSettings, properties.updateGoogleSignalsSettings metod, które umożliwiają kontrolowanie Google Signals w usłudze w Google Analytics 4.
  • delete_time expire_time pola z samymi danymi wyjściowymi zostały dodane do Property typu.

5.06.2021 Niezbędne zmiany.

Wprowadziliśmy te zmiany powodujące niezgodność:

  • properties.iosAppDataStreams.create, properties.androidAppDataStreams.create usunięto z interfejsu API metody. Użyj Firebase, aby utworzyć aplikację w usłudze w Google Analytics 4.
  • properties.delete zwraca teraz dane usuniętej usługi jako Property zamiast zwracać pustą odpowiedź.
  • time_zone pola Property typ jest teraz wymagany.
  • Pole deleted zostało usunięte z Property typu.
  • email_address pola UserLink typu nie można zmienić.
  • name pola UserLink typ jest teraz tylko wyjściowym.

28.01.2021 Zmiany ważne.

Zmiany powodujące niezgodność: – Pole update_mask jest wymagane dla wszystkich operacji aktualizacji.

  • Nazwa pola country_code została zmieniona na region_code w Account.

  • Nazwa pola url_query_parameter została zmieniona na uri_query_parameter w EnhancedMeasurementSettings.

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

20.10.2020 Dodano obsługę podsumowania konta.

Dodaliśmy obsługę metody polegającej na podsumowaniu konta.

13.10.2020: usługi Aplikacje + internet zostały zmienione na Google Analytics 4 (GA4).

15.08.2020 zmieniono nazwę interfejsu API zarządzania aplikacjami + internet na interfejs Admin API.

Nazwa interfejsu API do zarządzania aplikacjami + internet w Google Analytics została zmieniona na interfejs Google Analytics Admin API. W związku z tym punkt końcowy API zmienił się na analyticsadmin.googleapis.com. Istniejący kod napisany w porównaniu z poprzednią wersją adresu URL punktu końcowego API i biblioteki klienta należy odpowiednio zaktualizować.