迁移到 Google Analytics Admin API（用于用户删除）

旧版 Google Analytics User Deletion API (v3) 已随 Universal Analytics 一起停用。Google Analytics Admin API (v1alpha) 提供了一个替代 SubmitUserDeletion 方法，用于请求删除 Google Analytics 媒体资源中用户的数据。

我需要迁移吗？

如果您的代码仍在调用旧版 User Deletion API (v3) 的 upsert 方法，则必须迁移到 Google Analytics Admin API，才能为您的 Google Analytics 媒体资源执行用户删除操作。

迁移步骤

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

启用 Google Analytics Admin API

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

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

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

对旧版 User Deletion API 的 upsert 请求示例：

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

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

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

更新请求的 OAuth 范围

Google Analytics Admin API 的新 SubmitUserDeletion 使用范围 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 方法后，您就可以在 Google Cloud 云项目中停用旧版 API 了。

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