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

舊版 Google Analytics User Deletion API (v3) 已隨通用 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 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 控制台中開啟舊版通用 Analytics API 端點。選取 Cloud 專案，然後按一下「停用 API」按鈕。