Historique des transactions - XBOX Game Development Documentation

Economy v2 est maintenant en disponibilité générale. Pour obtenir du soutien et donner vos commentaires, rendez-vous sur le forum PlayFab.

Le service d’inventaire d’Economy v2 offre une API d’historique des transactions qui vous permet d’obtenir une vue de toutes les opérations effectuées sur l’inventaire d’un joueur. Ces données peuvent vous aider à suivre l’utilisation des systèmes de jeu, à résoudre des bogues et à repérer les acteurs malveillants. Les historiques des transactions sont regroupés selon les différentes collections d’inventaire d’un joueur, chaque collection ayant son propre historique. Vous trouverez plus d’information sur l’utilisation des CollectionId et sur la possibilité d’avoir plusieurs inventaires par joueur ici. Certains événements, comme CollectionCreated et CollectionDeleted, ne sont pas présentés dans l’historique des transactions.

Obtenir l’historique des transactions d’un joueur

Game Manager

Dans Game Manager, accédez à Players
Sélectionnez le joueur que vous souhaitez consulter, puis allez dans Transaction History

API

Vous pouvez utiliser l’API GetTransactionHistory pour obtenir l’historique des transactions d’un joueur. Un paramètre CollectionId est transmis pour indiquer l’historique de quelle collection d’inventaire consulter. Les joueurs peuvent uniquement accéder à leurs propres historiques de transactions. Les entités de titre peuvent transmettre un paramètre Entity pour indiquer à quel historique de transactions de joueur elles souhaitent accéder. Le paramètre Filter peut servir à transmettre des contraintes d’horodatage qui vous permettent de voir une plage de temps précise de transactions. Filter prend uniquement en charge timestamp ge (supérieur ou égal) et timestamp le (inférieur ou égal), et la période d’horodatage maximale pour consulter l’historique des transactions est de six mois. Exemple de requête 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"
}

Jetons de continuation

Le champ ContinuationToken retourné dans une réponse peut être transmis dans une requête d’historique des transactions pour paginer à travers plusieurs lots de résultats.

​Obtenir l’historique des transactions d’un joueur

​Game Manager

​API

​Jetons de continuation

Obtenir l’historique des transactions d’un joueur

Game Manager

API

Jetons de continuation