Pular para o conteúdo principal
Leia e altere o inventário do PlayFab Economy v2 com playfab economy inventory, incluindo coleções, histórico de transações e operações de inventário em lote. Os comandos de inventário têm como destino a entidade chamadora, a menos que você passe --entity-id e --entity-type. Para um jogador, passe a ID da conta de jogador do título dele com --entity-type title_player_account, e não a ID da conta de jogador mestre; playfab player account get a retorna como UserInfo.TitleInfo.TitlePlayerAccount.Id. --collection-id seleciona uma coleção de inventário diferente de default. operation execute recusa um lote que contenha uma operação Delete, a menos que você passe --confirm (--yes, -y), mesmo em um terminal. As outras alterações de inventário são executadas sem perguntar. Consulte Segurança e operações destrutivas.

Itens de inventário

  • inventory list retorna uma página de --limit itens, 10 por padrão. Para obter a próxima página, passe o token de continuação da resposta com --continuation-token.
  • --filter é um filtro OData sobre as propriedades de item type, id e stackId.
  • inventory add retorna ETag, IdempotencyId e as TransactionIds que registrou, e não o inventário alterado. Execute inventory list para ver o resultado.

Coleções de inventário

Operações de inventário

operation execute executa o lote como uma única transação. Assim como inventory add, ele retorna ETag, IdempotencyId e TransactionIds para o lote inteiro. Execute inventory list ou inventory transaction list para ver o que ele fez. operation status verifica uma transferência de inventário que não havia terminado quando sua solicitação retornou. TransferInventoryItems e ExecuteTransferOperations retornam um OperationToken enquanto o OperationStatus deles é InProgress; passe esse token e a GivingEntity da transferência como --entity-id e --entity-type. A CLI não tem nenhum comando para essas APIs de transferência; portanto, chame-as com playfab api. Uma ID de transação não é um token de operação, e o PlayFab a rejeita com Bad OperationToken.

Transações de inventário

--filter pode se referir a timestamp, transactionid, apiname e operationtype. --order-by aceita timestamp asc ou timestamp desc.

Saída em tabela

Estes comandos aceitam --output table; inventory add e operation execute não. Consulte Saída em tabela. Uma tabela não mostra o token de continuação; portanto, use a saída JSON para paginar além da primeira página.

Exemplos

Ler o inventário, as coleções e o histórico de transações de um jogador:
Adicionar uma unidade de um item ao inventário de um jogador:
Executar um lote de operações de inventário de ops.json:
Se ops.json contiver uma operação Delete, adicione --confirm:
Verificar uma transferência que retornou "OperationStatus": "InProgress", usando o OperationToken da resposta dela e o jogador que deu os itens:
Última modificação em 19 de novembro de 2026