W tym dokumencie opisano zasady wycofywania danych dla interfejsów API podstawowego 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 wycofywania danych mają na celu zwiększenie przejrzystości procesu wprowadzania tych zmian.
Wszystkie zmiany w kolumnach będą przekazywane za pomocą dzienników zmian, a interfejs Metadata API będzie automatycznie aktualizowany, aby uwzględnić te zmiany.
Zakres obowiązywania tych zasad
Ta zasada obejmuje wymiary i dane udostępniane przez publiczne interfejsy API. Nie obejmuje on żądań do 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 dodawane są nowe kolumny:
- W historii zmian odpowiedniego interfejsu API pojawią się szczegółowe informacje o nowych kolumnach.
- Kolumny będą dostępne w interfejsie Metadata API.
Usuwanie danych
Gdy kolumny zostaną usunięte z interfejsu API:
- W historii zmian odpowiedniego interfejsu API pojawią się szczegółowe informacje o usuwanych kolumnach.
- W interfejsie Metadata API atrybut kolumny
status
zostanie ustawiony naDEPRECATED
. - Kolumny te będą działać w zapytaniach raportowania przez co najmniej 6 miesięcy.
- Po 6 miesiącach te kolumny zostaną usunięte z interfejsu Metadata API, a wysyłanie do nich zapytań w interfejsie API do raportowania zakończy się błędem
400 Bad Request
.
Zmiana nazwy danych
Po zmianie nazw kolumn:
- W historii zmian odpowiedniego interfejsu API pojawią się szczegółowe informacje o kolumnach oryginalnych i zastępczych.
- W interfejsie Metadata API
atrybut
status
pierwotnej kolumny zostanie ustawiony naDEPRECATED
, a atrybutreplacedBy
zostanie ustawiony na identyfikator kolumny zastępczej. - Pierwotne kolumny będą działać w zapytaniach raportowania przez co najmniej 6 miesięcy.
- Po 6 miesiącach pierwotne kolumny zostaną usunięte z interfejsu Metadata API, a wysyłanie zapytań o te kolumny w interfejsie API do raportowania zakończy się błędem
400 Bad Request
.
Usunięcie atrybutu
Gdy atrybuty zostaną usunięte z interfejsu Metadata API:
- W historii zmian interfejsu Metadata API zostaną zaktualizowane szczegółowe informacje o usuwanych atrybutach.
- Atrybuty będą dostępne w Metadata API przez co najmniej 6 miesięcy.
- Po 6 miesiącach atrybuty zostaną usunięte z Metadata API.
Grupy
Czasami konieczna jest zmiana nazwy grupy lub kolejności kolumn. W takim przypadku:
- Historia zmian interfejsu Metadata API będzie zawierać szczegółowe informacje o nazwie grupy i zmianach w kolejności.