Uso
deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]
Todos os comandos exigem os parâmetros /e (e-mail) e /s (sandbox).
A entrada inicial com uma conta abre uma caixa de diálogo interativa para inserção de senha.
Depois de entrar com êxito, as operações seguintes com a mesma conta/sandbox no dispositivo não exigem mais a inserção da senha.
query
deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]
Lista todos os direitos de propriedade direta associados a essa conta na sandbox.
Saída do query
Exemplo de query
add
deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]
Adiciona à conta um direito para um ou mais produtos especificados.
Esse comando equivale a comprar o produto na Store ou por meio da API de compra.
A operação add com um jogo, durável, pacote ou consumível gerenciado pelo desenvolvedor do qual a conta já tem direito não adiciona outro direito, e a ferramenta informa o direito existente.
Para produtos consumíveis gerenciados pela Store, uma quantidade padrão de 1 é adicionada ao saldo do consumível em cada comando add.
Um valor de quantidade opcional pode ser especificado para alterar esse valor padrão, mas o campo de quantidade só pode ser usado se um único productID for passado com /p.
Essa opção é útil para consumíveis que concedem uma quantidade maior que 1 na compra.
Há suporte para /d para mais detalhes.
A quantidade não pode ser verificada com esta ferramenta.
add com um produto de pacote concede todos os produtos incluídos nele.
Se uma quantidade for especificada e o pacote incluir consumíveis gerenciados pela Store, a mesma quantidade será atribuída a cada consumível.
Não há suporte para produtos de assinatura.
Saída do add
Exemplos de add
Um único direito adicionadodelete
deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]
Exclui um ou mais direitos especificados da conta.
Se /all for especificado, a ferramenta tentará excluir todos os direitos associados à conta e à sandbox.
O status Revoked é exibido ao excluir direitos concedidos por esta ferramenta.
O status Refunded é exibido ao excluir direitos que foram comprados da forma convencional por meio do cliente da Store ou da API no jogo.
Há suporte para /d para mais detalhes.
Saída do delete
Exemplos de delete
catalog
deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]
Mostra o conjunto de produtos que podem ser vendidos pelo ID de produto fornecido; ou seja, produtos de complemento filhos e produtos com uma relação can use and sell com o productID no Partner Center.
Esse comando equivale ao retornado por XStoreQueryAssociatedProductsAsync.
Os produtos não são retornados quando configurados no Partner Center como disponíveis, mas não detectáveis na Microsoft Store.
Opcionalmente, um mercado pode ser especificado para recuperar os preços desse mercado específico.
O parâmetro precisa ser um código de região ISO de dois caracteres, por exemplo, GB, CA, JP, ES etc.
Saída do catalog
Exemplo de catalog
Comentários
Esta ferramenta é estritamente para uso com contas de teste XBOX e com produtos de sandbox. O uso com contas e cenários de varejo é bloqueado. Há um limite de operações add e delete por conta por dia. Esse limite é ajustado com base no uso observado. Para solicitar limites maiores ou enviar outros comentários, entre em contato com seu representante de conta da Microsoft.Documentação de referência da API
- XStore (conteúdo da API)
- Funções
- Estruturas