取引履歴 - XBOX Game Development Documentation

Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、PlayFab フォーラムを参照してください。

Economy v2 の Inventory サービスには、プレイヤーのインベントリに対して実行されたすべての操作のビューを取得できる Transaction History API があります。このデータは、ゲームシステムの使用状況の追跡、バグのトラブルシューティング、および悪意のあるアクターの特定に役立ちます。取引履歴はプレイヤーのさまざまなインベントリコレクションごとにグループ化され、各コレクションが独自の履歴を持ちます。CollectionId の使用およびプレイヤーごとに複数のインベントリを持つことについての詳細は、こちらを参照してください。 CollectionCreated や CollectionDeleted など、一部のイベントは取引履歴には表示されません。

プレイヤーの取引履歴の取得

Game Manager

Game Manager で Players に移動します
表示したいプレイヤーを選択し、Transaction History に移動します

API

GetTransactionHistory API を使用して、プレイヤーの取引履歴を取得できます。CollectionId パラメーターを渡して、表示するインベントリコレクションの履歴を指定します。プレイヤーは自分自身の取引履歴にのみアクセスできます。Title Entity では Entity パラメーターを渡して、アクセスしたいプレイヤーの取引履歴を指定できます。 Filter パラメーターを使用して、特定の期間の取引を確認できるタイムスタンプ制約を渡すことができます。Filter は timestamp ge (以上) と timestamp le (以下) のみをサポートし、取引履歴の表示には最大 6 か月間のタイムスタンプ期間の制限があります。 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 フィールドは、複数の結果件数をページングするために取引履歴リクエストに渡すことができます。

​プレイヤーの取引履歴の取得

​Game Manager

​API

​継続トークン

プレイヤーの取引履歴の取得

Game Manager

API

継続トークン