Passer au contenu principal
Lisez et modifiez l’inventaire de 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 transmettez à la fois --entity-id et --entity-type. Pour un joueur, transmettez l’ID de son compte de joueur du titre avec --entity-type title_player_account, et non l’ID de son compte de joueur principal; playfab player account get le retourne 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 transmettez --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 destructrices.

Éléments d’inventaire

  • inventory list retourne une page de --limit éléments, 10 par défaut. Pour obtenir la page suivante, transmettez le jeton de continuation de la réponse avec --continuation-token.
  • --filter est un filtre OData sur les propriétés d’élément type, id et stackId.
  • inventory add retourne 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 une seule transaction. Comme inventory add, elle retourne 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é lorsque sa requête a retourné une réponse. TransferInventoryItems et ExecuteTransferOperations retournent un OperationToken pendant que leur OperationStatus est InProgress; transmettez ce jeton, ainsi que l’entité GivingEntity du transfert avec --entity-id et --entity-type. La CLI n’a aucune 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 ne l’acceptent pas. 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 retourné "OperationStatus": "InProgress", en utilisant le OperationToken de sa réponse et le joueur qui a donné les éléments :
Dernière modification le 19 novembre 2026