Historique des transactions - XBOX Game Development Documentation

Economy v2 est désormais en disponibilité générale. Pour obtenir de l’aide et donner votre avis, rendez-vous sur le forum PlayFab.

Le service Inventory d’Economy v2 dispose d’une API Transaction History 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 les bogues et à identifier les acteurs malveillants. Les historiques de transactions sont regroupés par collections d’inventaire du joueur, chaque collection ayant son propre historique. Vous trouverez plus d’informations sur l’utilisation des CollectionId et sur la possession de 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 afficher, puis accédez à 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 afficher. Les joueurs ne peuvent accéder qu’à leur propre historique 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 être utilisé pour transmettre des contraintes d’horodatage qui vous permettent de voir une fenêtre de temps spécifique 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 pour l’affichage de l’historique des transactions est limitée à six mois au maximum. 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 renvoyé par une réponse peut être transmis dans une requête d’historique des transactions pour parcourir plusieurs pages 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