从 Google Analytics User Deletion API 迁移

旧版 Google Analytics User Deletion API 即将停用。Google Analytics Admin API 提供了一个替代 SubmitUserDeletion 方法，用于请求删除指定用户的数据。

我是否需要迁移？

如果您的代码调用的是旧版用户删除 API 的 upsert 方法，您需要迁移代码才能继续使用用户删除功能。

迁移步骤

请按照以下步骤开始使用新的 SubmitUserDeletion 方法。

启用 Google Analytics Admin API

点击以下启用 Google Analytics Admin API 按钮，选择或创建新的 Google Cloud 项目，并自动启用 Google Analytics Admin API。

启用 Google Analytics Admin API

查找并替换对旧版 User Deletion API 的调用

将对旧版 User Deletion API 的旧版 upsert 方法的所有调用替换为对 Google Analytics Admin API 的新版 SubmitUserDeletion 方法的调用。

向旧版 User Deletion API 发出的 upsert 请求示例：

REST

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

Google Analytics Admin API 的等效 SubmitUserDeletion 请求示例：

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。

这与使用 https://www.googleapis.com/auth/analytics.user.deletion 范围的旧版 User Deletion API 不同。

您应更新所有使用 https://www.googleapis.com/auth/analytics.user.deletion 的代码或访问令牌请求命令，以改为请求 https://www.googleapis.com/auth/analytics.edit。

如果您使用的是客户端库，该库应会自动请求必要的范围。

停用旧版 API

将代码更新为使用 SubmitUserDeletion 方法后，您就可以在 Google Cloud 项目中停用旧版 API 了。

打开以下链接，在 Google Cloud 控制台中打开旧版 Universal Analytics API 端点。选择您的 Cloud 项目，然后点击停用 API 按钮。