遷移至 Google Analytics Admin API，刪除使用者

舊版 Google Analytics User Deletion API (第 3 版) 已隨通用 Analytics 淘汰。Google Analytics Admin API (v1alpha) 提供替代方法，可要求刪除 Google Analytics 資源中使用者資料。SubmitUserDeletion

我需要遷移嗎？

如果您的程式碼仍呼叫舊版 User Deletion API (第 3 版) 的 upsert 方法，就必須遷移至 Google Analytics Admin API，才能為 Google Analytics 資源刪除使用者。

遷移步驟

如要開始使用新的 SubmitUserDeletion 方法，請按照下列步驟操作。

啟用 Google Analytics Admin API

按一下「啟用 Google Analytics Admin API」按鈕，選取或建立新專案 ，並自動啟用 Google Analytics Admin API。

啟用 Google Analytics 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。

這與舊版 User Deletion API 不同，舊版 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 控制台中開啟舊版通用 Analytics API 端點。選取雲端專案，然後按一下「停用 API」按鈕。