交易历史 - 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年8月13日