交易記錄 - XBOX Game Development Documentation

Economy v2 現已正式推出。如需支援與意見反應，請前往 PlayFab 論壇。

Economy v2 庫存服務提供交易記錄 API，可讓您檢視在玩家庫存上執行的所有作業。這些資料可用於協助追蹤遊戲系統的使用情況、針對錯誤進行疑難排解，以及識別惡意行為者。交易記錄會依玩家的不同庫存集合分組，每個集合都有自己的記錄。如需使用 CollectionId 以及讓每位玩家擁有多個庫存的詳細資訊，請參閱這裡。部分事件 (例如 CollectionCreated 和 CollectionDeleted) 不會顯示在交易記錄中。

取得玩家的交易記錄

Game Manager

在 Game Manager 中，瀏覽至 Players
選取您要檢視的玩家，然後前往 Transaction History

API

您可以使用 GetTransactionHistory API 取得玩家的交易記錄。傳入 CollectionId 參數以指出要檢視哪個庫存集合的記錄。玩家僅能存取自己的交易記錄。遊戲實體 (Title Entities) 可以傳入 Entity 參數，以指出要存取哪位玩家的交易記錄。 Filter 參數可用於傳入時間戳記條件，讓您查看特定時間範圍內的交易。Filter 僅支援 timestamp ge (大於或等於) 和 timestamp le (小於或等於)，且檢視交易記錄的時間戳記期間上限為六個月。 GetTransactionHistory 要求範例：

{
    "Entity": {
        "Id": "ABCD12345678",
        "Type": "title_player_account",
    },
    "CollectionId": "default",
    "Count": 10,
    "Filter": "timestamp ge 2021-12-30T23:00Z and timestamp le 2021-12-31T23:00Z"
}

接續權杖

回應所傳回的 ContinuationToken 欄位，可以傳入交易記錄要求中，以分頁瀏覽多批結果。

最後修改於 2026年10月6日

⌘I

​取得玩家的交易記錄

​Game Manager

​API

​接續權杖

取得玩家的交易記錄

Game Manager

API

接續權杖