跳轉到主要內容

刪除玩家資料

本文說明從 PlayFab 刪除玩家資料的兩種主要方式。您可以刪除整個玩家帳戶,或只刪除資料而不刪除帳戶。

刪除玩家帳戶

刪除主要玩家帳戶會從 PlayFab 刪除與該玩家相關聯的所有資料,等同於從您的遊戲中刪除該玩家。DeleteMasterPlayerAccount API 沒有選擇性刪除玩家相關資料的機制。如需刪除資料並保留玩家帳戶的選項,請參閱「刪除事件資料」和「刪除自訂資料」。
您可以使用 DeleteMasterPlayerAccount Admin API 來刪除主要玩家帳戶及其資料,我們所有的 SDK 都提供此 API。請閱讀確定您找到所有資料。 當您提出刪除玩家的要求時,PlayFab 會先快速從我們的核心系統移除玩家的個人資訊,再將要求傳送給佇列處理代理程式,由其負責從附屬系統和次級處理者移除玩家的任何剩餘資訊。 此 API 會立即傳回,並提供 JobReceiptId,您應該將其儲存以供記錄。JobReceiptId 是 PlayFab 已收到刪除玩家要求的驗證。 刪除完成後,系統會傳送電子郵件至為遊戲設定的通知電子郵件地址。其中包含 API 最初傳回的相同 JobReceiptId。工作完成也會觸發 PlayStream 事件。 使用我們的 Webhook 功能,您可以註冊在您選擇的端點上接收這些事件,並視需要處理它們。該事件會包含具有 JobReceiptId 的 JSON Blob。 下列範例示範如何搭配 C# SDK 使用 Admin API。如果您想使用不同的 SDK,請從 PlayFab SDK 清單中選取一個。
由於此刪除無法復原,建議您與玩家確認他們能接受其刪除要求的範圍和影響。
確認動作後,使用下列程式碼繼續刪除主要玩家帳戶。

刪除帳戶資料而不刪除帳戶

使用此清單協助您刪除與玩家帳戶相關聯的事件資料。

刪除事件資料

事件資料包括 PlayStream 事件和遙測。事件資料屬於交易性資料,由使用者活動產生。

PlayFab Insights

PlayFab Insights 是完全受控的解決方案,由 PlayFab 代表您儲存事件資料。 當玩家提出要求時,您可以使用 DeleteMasterPlayerEventData API 刪除 Insights 資料。這只會刪除 PlayFab Insights 中與該玩家相關的已儲存資料,其他所有資料則保持不變。

刪除自訂資料

自訂資料是指一大類功能,可讓您將任意資料與玩家建立關聯。PlayFab 提供從遊戲邏輯與資料互動的方法,但不會以其他方式解譯或理解這些資料。

舊版玩家資料

您可以使用下列 API 編輯和刪除不同類型的玩家資料: UpdateUserData, UpdateUserInternalData, UpdateUserReadOnlyData, UpdateUserPublisherData, UpdateUserPublisherInternalData, UpdateUserPublisherReadOnlyData 這些 API 都會接受參數 KeysToRemove,該參數接受應從玩家設定檔中刪除的玩家資料索引鍵清單。

實體物件

您可以使用 SetObjects API 刪除實體物件。在要求本文的 Objects 陣列中,為每個要刪除的物件建立一個項目,方法是指定其 ObjectName 並將 DeleteObject 設定為 true。以下是要求本文的範例。

實體檔案

實體檔案是使用 DeleteFiles API 刪除。
最後修改於 2026年10月6日