本文件提供 Google Analytics (分析) User Deletion API 的概要總覽。
簡介
Google Analytics (分析) User Deletion API 可讓客戶處理與特定使用者 ID 相關的資料刪除作業。這項工具是可協助您保護資料的多項工具之一。
總覽
User Deletion API 可讓 Google Analytics (分析) 客戶從專案或網站資源中刪除特定使用者 ID 的資料。您可以透過 Firebase 專案或 Google Analytics (分析) 資源提出使用者刪除要求。
正在要求刪除資料
使用 upsert 方法要求刪除特定使用者的資料。更新/插入方法使用使用者刪除要求資源做為唯一的參數。資料刪除要求可套用至 Google Analytics (分析) 網站資源 (以 webPropertyId 欄位指定) 或 GA4 資源 (由 propertyId 欄位指定)。如要指定要刪除資料的使用者，請在 id.userId 欄位中設定其中一個 ID。您必須在 id.type 欄位中指定 ID 類型。支援的使用者 ID 類型：
- CLIENT_ID： Google Analytics (分析) 用戶端 ID (僅適用於已設定 webPropertyId 或 propertyId 欄位的情況)。
- USER_ID： Google Analytics (分析) User ID (只有在已設定 webPropertyId 或 propertyId 欄位時，才能使用此 ID)。
- APP_INSTANCE_ID：Firebase 應用程式執行個體 ID (僅適用於已設定 firebaseProjectId 或 propertyId 欄位時)。
如要進一步瞭解 User ID 和 Client ID 功能，請前往 Analytics (分析) 說明中心。
資料刪除
upsert 方法會傳回具有 deletionRequestTime 欄位的使用者刪除要求資源。deletionRequestTime 欄位會標示 Google Analytics (分析) 收到刪除要求的時間點。
需要 https://www.googleapis.com/auth/analytics.user.deletion OAuth 2.0 範圍才能呼叫 upsert 方法。