Zasady wycofywania danych dla interfejsów API Google Analytics

W tym dokumencie opisano zasady wycofania danych dotyczące podstawowych interfejsów API do raportowania i metadanych.

Przegląd

Wymiary i dane (kolumny) służą do wysyłania zapytań do interfejsów API raportowania Google Analytics. Czasami trzeba dodać lub usunąć te kolumny albo zmienić ich nazwy. Zasady udostępniania danych są udostępniane, aby zapewnić przejrzystość informacji o wprowadzaniu tych zmian.

Wszystkie zmiany będą informowane w dziennikach zmian, a interfejs Metadata API będzie automatycznie aktualizowany, aby uwzględnić te zmiany.

Co obejmuje ta zasada

Ta zasada obejmuje wymiary i dane dostępne przez publiczne interfejsy API. Nie dotyczy to żądania interfejsu API (parametrów zapytania), odpowiedzi interfejsu API, wartości zwracanych przez interfejs API ani prawidłowych kombinacji wymiarów i danych.

Nowe dane

Gdy do interfejsu API zostaną dodane nowe kolumny:

  • Dziennik zmian odpowiedniego interfejsu API zostanie zaktualizowany o informacje na temat nowych kolumn.
  • Kolumny będą dostępne w interfejsie Metadata API.

Usuwanie danych

Gdy kolumny zostaną usunięte z interfejsu API:

  • Historia zmian odpowiedniego interfejsu API zostanie zaktualizowana o szczegóły dotyczące usuwanych kolumn.
  • W interfejsie Metadata API atrybut status będzie ustawiony na DEPRECATED.
  • Kolumny będą działać w zapytaniach jeszcze przez co najmniej 6 miesięcy.
  • Po 6 miesiącach kolumny zostaną usunięte z interfejsu Metadata API, a zapytania dotyczące tych kolumn w interfejsie raportowania spowodują wyświetlenie błędu 400 Bad Request.

Zmiana nazwy danych

Po zmianie nazw kolumn:

  • Historia zmian odpowiedniego interfejsu API zostanie zaktualizowana o szczegółowe informacje o pierwotnej i zastępczej kolumnie.
  • W interfejsie Metadata API atrybut status pierwotnej kolumny zostanie ustawiony na DEPRECATED, a atrybut replacedBy – identyfikator kolumny zastępczej.
  • Pierwotne kolumny będą nadal działać w raportach przez co najmniej 6 miesięcy.
  • Po 6 miesiącach pierwotne kolumny zostaną usunięte z interfejsu Metadata API, a zapytania o kolumny będą powodować błąd 400 Bad Request.

Usunięcie atrybutu

Gdy atrybuty zostaną usunięte z interfejsu Metadata API:

Grupy

Czasami konieczna jest zmiana nazwy grupy lub kolejności kolumn. W takim przypadku: