Переход на Google Analytics Admin API для удаления данных пользователей

Устаревшая версия User Deletion API Google Аналитики (v3) была отключена вместе с Universal Analytics. В Google Analytics Admin API (v1alpha) есть метод SubmitUserDeletion, который позволяет запрашивать удаление данных пользователей в ресурсах Google Аналитики.

Нужно ли мне переходить на новую версию?

Если в вашем коде по-прежнему вызывается метод upsert устаревшего User Deletion API (версия 3), вам необходимо перейти на Google Analytics Admin API, чтобы удалять пользователей из ресурсов Google Аналитики.

Этапы перехода

Чтобы начать использовать новый метод SubmitUserDeletion, выполните следующие действия:

Как включить Google Analytics Admin API

Нажмите кнопку Включить Google Analytics Admin API, чтобы выбрать или создать новый проект и автоматически включить Google Analytics Admin API.

Как включить API Google Аналитики

Как найти и заменить вызовы устаревшего User Deletion API

Замените все вызовы устаревшего метода upsert устаревшего User Deletion API на вызовы нового метода SubmitUserDeletion Google Analytics Admin API.

Пример запроса upsert к устаревшему User Deletion API:

REST

  POST https://analytics.googleapis.com/analytics/v3/userDeletion/userDeletionRequests:upsert
  {
    "propertyId": "1234567",
    "id": {
      "type": "USER_ID",
      "userId": "user123"
    }
  }

Пример эквивалентного запроса SubmitUserDeletion в Google Analytics Admin API:

REST

  POST https://analyticsadmin.googleapis.com/v1alpha/properties/1234567:submitUserDeletion
  {
    "userId": "user123"
  }

Как изменить запрошенные области действия OAuth

Новая SubmitUserDeletion Google Analytics Admin API использует область действия https://www.googleapis.com/auth/analytics.edit.

Это отличается от устаревшего User Deletion API, в котором использовалась область https://www.googleapis.com/auth/analytics.user.deletion.

Вам нужно обновить все команды для запроса кода или токена доступа, в которых используется https://www.googleapis.com/auth/analytics.user.deletion, чтобы вместо него запрашивался https://www.googleapis.com/auth/analytics.edit.

Если вы используете клиентскую библиотеку, она должна запрашивать необходимые области действия автоматически.

Как отключить устаревший API

После того как вы обновите код, чтобы использовать метод SubmitUserDeletion, можно отключить устаревший API в облачном проекте Google Cloud.

Откройте следующую ссылку, чтобы открыть конечную точку устаревшего API Universal Analytics в консоли Google Cloud. Выберите проект Google Cloud и нажмите кнопку Отключить API.