> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy

> Inspectez et modifiez les éléments, les collections et les transactions d'inventaire d'Economy v2, et exécutez des opérations d'inventaire par lots.

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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/player) 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](https://docs.xbox.com/fr-CA/tools/xbox-cli/safety.md).

## Éléments d'inventaire

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab economy inventory list` | `/Inventory/GetInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token`, `--filter` facultatives. |
| `playfab economy inventory add` | `/Inventory/AddInventoryItems` | `--entity-id`, `--entity-type`, `--collection-id`, `--idempotency-id` facultatives. L'élément : `--item-id` avec `--stack-id` facultative, ou un objet JSON `InventoryItemReference` avec `--item`. `--amount` définit la quantité. |

* `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

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab economy inventory collection list` | `/Inventory/GetInventoryCollectionIds` | `--entity-id`, `--entity-type`, `--limit`, `--continuation-token` facultatives. |

## Opérations d'inventaire

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab economy inventory operation execute` | `/Inventory/ExecuteInventoryOperations` | `--entity-id`, `--entity-type`, `--collection-id`, `--idempotency-id` facultatives. Les opérations, sous forme de tableau JSON, avec exactement une des options `--operations` ou `--operations-file`. |
| `playfab economy inventory operation status` | `/Inventory/GetInventoryOperationStatus` | `--operation-token` (obligatoire); `--entity-id` et `--entity-type` de l'entité qui a donné les éléments; `--collection-id` facultative. |

`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`](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands/playfab/api). Un ID de transaction n'est pas un
jeton d'opération, et PlayFab le rejette avec `Bad OperationToken.`

## Transactions d'inventaire

| Commande | Chemin de l'API PlayFab | Options |
| - | - | - |
| `playfab economy inventory transaction list` | `/Inventory/GetTransactionHistory` | `--entity-id`, `--entity-type`, `--collection-id`, `--limit`, `--continuation-token`, `--filter`, `--order-by` facultatives. |

`--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](https://docs.xbox.com/fr-CA/tools/xbox-cli/commands.md#table-output).

| Commande | Colonnes |
| - | - |
| `playfab economy inventory list` | `ID`, `TYPE`, `STACK`, `AMOUNT` |
| `playfab economy inventory collection list` | `COLLECTION ID` |
| `playfab economy inventory transaction list` | `TRANSACTION ID`, `TIMESTAMP`, `API`, `OPERATION` |
| `playfab economy inventory operation status` | `STATUS` |

Un tableau n'affiche pas le jeton de continuation; utilisez donc la sortie JSON pour aller au-delà de la première
page.

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory list --entity-id TITLEPLAYER123 --entity-type title_player_account --output table
```

```text theme={null}
ID                                    TYPE      STACK    AMOUNT
------------------------------------  --------  -------  ------
11111111-2222-3333-4444-555555555555  currency  default  500
22222222-3333-4444-5555-666666666666  bundle    default  1
```

## Exemples

Lire l'inventaire, les collections et l'historique des transactions d'un joueur :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory list --entity-id TITLEPLAYER123 --entity-type title_player_account --limit 50 --data-only --output json-compact
xbox --playfab-title-id ABC123 playfab economy inventory collection list --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab economy inventory transaction list --entity-id TITLEPLAYER123 --entity-type title_player_account --order-by "timestamp desc"
```

Ajouter un exemplaire d'un élément à l'inventaire d'un joueur :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory add --entity-id TITLEPLAYER123 --entity-type title_player_account --item-id 11111111-2222-3333-4444-555555555555 --amount 1 --idempotency-id 22222222-3333-4444-5555-666666666666
```

Exécuter un lot d'opérations d'inventaire à partir de `ops.json` :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation execute --entity-id TITLEPLAYER123 --entity-type title_player_account --operations-file ops.json --idempotency-id 33333333-4444-5555-6666-777777777777
```

Si `ops.json` contient une opération `Delete`, ajoutez `--confirm` :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation execute --entity-id TITLEPLAYER123 --entity-type title_player_account --operations-file ops.json --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 :

```bash theme={null}
xbox --playfab-title-id ABC123 playfab economy inventory operation status --entity-id TITLEPLAYER123 --entity-type title_player_account --operation-token OPERATIONTOKEN123
```


## Related topics

- [Catalogues (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Objets (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/items/index.md)
- [Magasins (Economy hérité)](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy/stores/index.md)
- [Abonnements dans Economy v2](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy-v2/catalog/subscriptions.md)
- [Limites d'Economy V2](https://docs.xbox.com/fr-CA/services/playfab/economy-monetization/economy-v2/limits.md)
