Passer au contenu principal
Lisez et modifiez l’inventaire PlayFab Economy v2 avec playfab economy inventory, y compris les collections, l’historique des transactions et les opérations d’inventaire par lots. Les commandes d’inventaire ciblent l’entité appelante, sauf si vous passez à la fois --entity-id et --entity-type. Pour un joueur, passez l’ID de son compte joueur de titre avec --entity-type title_player_account, et non l’ID de son compte joueur principal ; playfab player account get le renvoie sous la forme UserInfo.TitleInfo.TitlePlayerAccount.Id. --collection-id sélectionne une collection d’inventaire autre que default. operation execute refuse un lot qui contient une opération Delete, sauf si vous passez --confirm (--yes, -y), même dans un terminal. Les autres modifications de l’inventaire s’exécutent sans demander de confirmation. Consultez Sécurité et opérations destructives.

Éléments d’inventaire

  • inventory list renvoie une page de --limit éléments, 10 par défaut. Pour obtenir la page suivante, passez le jeton de continuation de la réponse avec --continuation-token.
  • --filter est un filtre OData portant sur les propriétés d’élément type, id et stackId.
  • inventory add renvoie ETag, IdempotencyId et les TransactionIds qu’elle a enregistrés, et non l’inventaire modifié. Exécutez inventory list pour voir le résultat.

Collections d’inventaire

Opérations d’inventaire

operation execute exécute le lot en tant que transaction unique. Comme inventory add, elle renvoie ETag, IdempotencyId et TransactionIds pour l’ensemble du lot. Exécutez inventory list ou inventory transaction list pour voir ce qu’elle a fait. operation status vérifie un transfert d’inventaire qui n’était pas terminé au retour de sa requête. TransferInventoryItems et ExecuteTransferOperations renvoient un OperationToken tant que leur OperationStatus vaut InProgress ; passez ce jeton, ainsi que le GivingEntity du transfert en tant que --entity-id et --entity-type. La CLI n’a pas de commande pour ces API de transfert : appelez-les donc avec playfab api. Un ID de transaction n’est pas un jeton d’opération, et PlayFab le rejette avec Bad OperationToken.

Transactions d’inventaire

--filter peut faire référence à timestamp, transactionid, apiname et operationtype. --order-by accepte timestamp asc ou timestamp desc.

Sortie sous forme de tableau

Ces commandes acceptent --output table ; inventory add et operation execute non. Consultez Sortie sous forme de tableau. Un tableau n’affiche pas le jeton de continuation : utilisez donc la sortie JSON pour aller au-delà de la première page.

Exemples

Lire l’inventaire, les collections et l’historique des transactions d’un joueur :
Ajouter un exemplaire d’un élément à l’inventaire d’un joueur :
Exécuter un lot d’opérations d’inventaire à partir de ops.json :
Si ops.json contient une opération Delete, ajoutez --confirm :
Vérifier un transfert qui a renvoyé "OperationStatus": "InProgress", en utilisant l’OperationToken de sa réponse et le joueur qui a donné les éléments :
Dernière modification le 19 novembre 2026