> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 交易历史

> 查询 PlayFab Economy v2 交易历史 API 以审核在玩家账户上执行的库存操作、购买和物品授予。

<Info>
  Economy v2 现已正式发布。如需支持和反馈，请访问 [PlayFab 论坛](https://community.playfab.com)。
</Info>

Economy v2 库存服务有一个交易历史 API，允许你查看玩家库存上执行的所有操作。此数据可用于帮助跟踪游戏系统的使用情况、排查错误并识别恶意行为者。

交易历史按玩家的不同库存集合分组，每个集合都有自己的历史。有关使用 `CollectionId` 和每个玩家拥有多个库存的更多信息，请参见[此处](/services/playfab/economy-monetization/economy-v2/inventory/collections)。

某些事件（如 CollectionCreated 和 CollectionDeleted）不会显示在交易历史中。

## 获取玩家的交易历史

### Game Manager

1. 在 [Game Manager](/services/playfab/live-service-management/gamemanager) 中，导航到 `Players`
2. 选择你要查看的玩家，然后转到 `Transaction History`

### API

你可以使用 `GetTransactionHistory` API 获取玩家的交易历史。传入 `CollectionId` 参数以指示要查看哪个库存集合的历史。玩家仅限于访问自己的交易历史。Title Entities 可以传入 `Entity` 参数以指示他们希望访问哪个玩家的交易历史。

`Filter` 参数可用于传入时间戳约束，让你可以查看特定时间窗口的交易。`Filter` 仅支持 `timestamp ge`（大于或等于）和 `timestamp le`（小于或等于），并且查看交易历史的时间戳期限最长为六个月。

`GetTransactionHistory` 请求示例：

```json theme={null}
{
    "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` 字段可以传入交易历史请求，以分页浏览多个计数的结果。