User Deletion API - 總覽

本文件將概略介紹 Google Analytics (分析) User Deletion API。

簡介

透過 Google Analytics (分析) User Deletion API,客戶可以處理與特定使用者 ID 相關聯的資料刪除作業。這項工具提供多項工具,可協助您保護資料

總覽

User Deletion API 可讓 Google Analytics (分析) 客戶從專案或網站資源中刪除特定使用者 ID 的資料。您可以使用 Firebase 專案或 Google Analytics (分析) 資源提出使用者刪除要求。

要求刪除資料

您可以使用 upsert 方法,要求刪除特定使用者的資料。upsert 方法會將使用者刪除要求資源做為唯一的參數。資料刪除要求可套用到 Google Analytics (分析) 網站資源 (由 webPropertyId 欄位指定) 或 GA4 資源 (由 propertyId 欄位指定)。只要在 id.userId 欄位中設定其中一個 ID,來指定要刪除其資料的使用者。必須在 id.type 欄位中指定 ID 類型。支援的使用者 ID 類型:

  • CLIENT_ID:Google Analytics (分析) 用戶端 ID (只有在設定 webPropertyIdpropertyId 欄位時才支援)。
  • USER_ID: Google Analytics (分析) 使用者 ID (必須先設定 webPropertyIdpropertyId 欄位才能支援)。
  • APP_INSTANCE_ID:Firebase 應用程式執行個體 ID (只有在設定 firebaseProjectIdpropertyId 欄位時支援)

如要進一步瞭解 User-ID 和用戶端 ID 功能,請前往 Analytics (分析) 說明中心

資料刪除

upsert 方法會傳回已設定 deletionRequestTime 欄位的使用者刪除要求資源deletionRequestTime 欄位會標示 Google Analytics (分析) 收到刪除要求的時間點。

必須使用 https://www.googleapis.com/auth/analytics.user.deletion OAuth 2.0 範圍才能呼叫 upsert 方法。