Zasady wycofania danych z interfejsów API Google Analytics

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 na DEPRECATED.
  • 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 na DEPRECATED, a atrybut replacedBy 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:

Grupy

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