> ## 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.

# items_redeemed

> ItemsRedeemed event.

兑换物品到库存时引发的事件。

## 属性

| 名称                       | 类型     | 说明               |
| :----------------------- | :----- | :--------------- |
| TransactionId            | String | 交易 ID。           |
| CollectionId             | String | 集合 ID。           |
| ItemId                   | String | 物品 ID。           |
| StackId                  | String | 堆栈 ID。           |
| Amount                   | int?   | 兑换的物品数量。         |
| DurationInSeconds        | long?  | 兑换的物品的持续时间。      |
| Marketplace              | String | 兑换物品来源的市场名称。     |
| MarketplaceTransactionId | String | 兑换物品来源市场中的交易 ID。 |
| ItemType                 | String | 交易中修改的目录物品的类型。   |
| Balance                  | int?   | 因交易而更改的物品余额。     |

## 通用属性

所有 V2 PlayStream 事件都被格式化为 JSON 对象，且大多数共享以下通用属性：

| 名称                 | 类型                                                                            | 说明                                          |
| :----------------- | :---------------------------------------------------------------------------- | :------------------------------------------ |
| SchemaVersion      | String                                                                        | PlayStream 事件格式版本，遵循语义化版本方案。                |
| FullName           | [Object](/services/playfab/api-references/events/data-types/fullnameobject)   | 事件名称和事件命名空间的组合，用于完全指定事件类型。                  |
| Id                 | String                                                                        | 由 PlayFab 分配的此事件的唯一标识符。                     |
| Timestamp          | DateTime                                                                      | 与此事件关联的时间（UTC）。                             |
| Entity             | [Object](/services/playfab/api-references/events/data-types/entityobject)     | 此事件所应用于的实体的详细信息，包括 Entity Id 和 Entity type。 |
| Originator         | [Object](/services/playfab/api-references/events/data-types/originatorobject) | 描述发起此事件的来源和来源类型的对象。                         |
| PayloadContentType | String                                                                        | 指定事件负载的内容。默认为 "JSON"。                       |
| Origin Info        | Object                                                                        | 可选字段，包含来自 PlayFab 外部的事件的相关信息。               |


## Related topics

- [欺诈防范、兑换、收据验证](/zh-CN/services/playfab/economy-monetization/economy-v2/fraud-prevention/index.md)
- [PlayFab 的 PlayStream 事件模型参考](/zh-CN/services/playfab/api-references/events/index.md)
- [兑换 Apple App Store 应用内购](/zh-CN/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/apple.md)
- [使用 Google 市场进行兑换](/zh-CN/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google.md)
- [使用 Microsoft Store 市场进行兑换](/zh-CN/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)