Политика устаревания данных для API Google Analytics

В этом документе описывается политика прекращения поддержки данных для основных API-интерфейсов отчетов и метаданных.

Обзор

Параметры и показатели (столбцы) используются для запроса API отчетов Google Analytics. Иногда необходимо добавить, удалить или переименовать эти столбцы. Политика устаревания данных предназначена для повышения прозрачности того, как происходят эти изменения.

Обо всех изменениях в столбцах будет сообщаться через журналы изменений , и API метаданных будет автоматически обновляться, чтобы отразить эти изменения.

Что покрывается настоящей политикой

Эта политика охватывает параметры и показатели, предоставляемые общедоступными API. Он не распространяется на запрос API (параметры запроса), ответ API, значения, возвращаемые API, а также допустимые комбинации параметров и показателей.

Новые данные

Когда в API добавляются новые столбцы:

Удаление данных

Когда столбцы удаляются из API:

  • Журнал изменений соответствующего API будет обновлен с указанием сведений об удаляемых столбцах.
  • В API метаданных атрибуту status столбца будет присвоено DEPRECATED .
  • Столбцы будут продолжать работать в запросах отчетов в течение как минимум 6 месяцев.
  • Через 6 месяцев столбцы будут удалены из API метаданных , а запрос столбцов в API отчетов приведет к ошибке 400 Bad Request .

Переименование данных

При переименовании столбцов:

  • Журнал изменений соответствующего API будет обновлен с указанием сведений об исходных и заменяющих столбцах.
  • В API метаданных атрибуту status исходного столбца будет присвоено DEPRECATED , а атрибуту replacedBy будет присвоен идентификатор замещающего столбца.
  • Исходные столбцы будут продолжать работать в запросах отчетов в течение как минимум 6 месяцев.
  • Через 6 месяцев исходные столбцы будут удалены из API метаданных , а запрос столбцов в API отчетов приведет к ошибке 400 Bad Request .

Удаление атрибута

Когда атрибуты удаляются из API метаданных:

  • Журнал изменений API метаданных будет обновлен с подробной информацией об удаляемых атрибутах.
  • Атрибуты будут доступны в API метаданных в течение как минимум 6 месяцев.
  • Через 6 месяцев атрибуты будут удалены из API метаданных .

Группы

Иногда необходимо изменить название группы или порядок столбцов. Когда это происходит: