Saltar al contenido principal
Lee y cambia el inventario de PlayFab Economy v2 con playfab economy inventory, incluidas las colecciones, el historial de transacciones y las operaciones de inventario por lotes. Los comandos de inventario actúan sobre la entidad que realiza la llamada, a menos que pases tanto --entity-id como --entity-type. Para un jugador, pasa su identificador de cuenta de jugador de título con --entity-type title_player_account, no su identificador de cuenta de jugador maestra; playfab player account get lo devuelve como UserInfo.TitleInfo.TitlePlayerAccount.Id. --collection-id selecciona una colección de inventario distinta de default. operation execute rechaza un lote que contiene una operación Delete a menos que pases --confirm (--yes, -y), incluso en un terminal. Los demás cambios de inventario se ejecutan sin preguntar. Consulta Seguridad y operaciones destructivas.

Elementos del inventario

  • inventory list devuelve una página de --limit elementos, 10 de forma predeterminada. Para obtener la página siguiente, pasa el token de continuación de la respuesta con --continuation-token.
  • --filter es un filtro de OData sobre las propiedades de elemento type, id y stackId.
  • inventory add devuelve ETag, IdempotencyId y los TransactionIds que registró, no el inventario modificado. Ejecuta inventory list para ver el resultado.

Colecciones del inventario

Operaciones de inventario

operation execute ejecuta el lote como una sola transacción. Al igual que inventory add, devuelve ETag, IdempotencyId y TransactionIds para todo el lote. Ejecuta inventory list o inventory transaction list para ver lo que hizo. operation status comprueba una transferencia de inventario que no había terminado cuando se devolvió su solicitud. TransferInventoryItems y ExecuteTransferOperations devuelven un OperationToken mientras su OperationStatus es InProgress; pasa ese token y el GivingEntity de la transferencia como --entity-id y --entity-type. La CLI no tiene ningún comando para esas API de transferencia, así que llámalas con playfab api. Un identificador de transacción no es un token de operación, y PlayFab lo rechaza con Bad OperationToken.

Transacciones de inventario

--filter puede hacer referencia a timestamp, transactionid, apiname y operationtype. --order-by acepta timestamp asc o timestamp desc.

Salida en tabla

Estos comandos aceptan --output table; inventory add y operation execute no. Consulta Salida en tabla. Una tabla no muestra el token de continuación, así que usa la salida JSON para pasar de la primera página.

Ejemplos

Leer el inventario, las colecciones y el historial de transacciones de un jugador:
Agregar una unidad de un elemento al inventario de un jugador:
Ejecutar un lote de operaciones de inventario desde ops.json:
Si ops.json contiene una operación Delete, agrega --confirm:
Comprobar una transferencia que devolvió "OperationStatus": "InProgress", con el OperationToken de su respuesta y el jugador que entregó los elementos:
Última modificación el 19 de noviembre de 2026