> ## 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 の Transaction History API をクエリして、プレイヤーのアカウントで実行されたインベントリ操作、購入、アイテム付与を監査します。

<Info>
  Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、[PlayFab フォーラム](https://community.playfab.com) を参照してください。
</Info>

Economy v2 の Inventory サービスには、プレイヤーのインベントリに対して実行されたすべての操作のビューを取得できる Transaction History 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 Entity では `Entity` パラメーターを渡して、アクセスしたいプレイヤーの取引履歴を指定できます。

`Filter` パラメーターを使用して、特定の期間の取引を確認できるタイムスタンプ制約を渡すことができます。`Filter` は `timestamp ge` (以上) と `timestamp le` (以下) のみをサポートし、取引履歴の表示には最大 6 か月間のタイムスタンプ期間の制限があります。

`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` フィールドは、複数の結果件数をページングするために取引履歴リクエストに渡すことができます。


## Related topics

- [Economy V2 の制限](/ja-jp/services/playfab/economy-monetization/economy-v2/limits.md)
- [アイテムとインベントリの概要](/ja-jp/services/playfab/economy-monetization/economy-v2/inventory/items-and-inventory-overview.md)
- [Microsoft Store マーケットプレイスでの引き換え](/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)
- [Apple App Store のアプリ内購入の引き換え](/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/apple.md)
- [Google マーケットプレイスでの引き換え](/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google.md)