Uso
deventitlementtool <command> /e <testaccountemail> /s <sandboxid> [/p <productid>] [...]
Todos los comandos requieren los parámetros /e (correo electrónico) y /s (sandbox).
El inicio de sesión inicial con una cuenta invoca un cuadro de diálogo interactivo para escribir la contraseña.
Una vez que se ha iniciado sesión correctamente, las operaciones posteriores con la misma cuenta y sandbox en el dispositivo ya no requieren escribir la contraseña.
query
deventitlementtool query /e <testaccountemail> /s <sandboxid> [/d]
Enumera todos los derechos de propiedad directa asociados a esta cuenta en el sandbox.
Salida de query
Ejemplo de query
add
deventitlementtool add /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/q <quantity>] [/d]
Agrega a la cuenta un derecho para uno o varios productos especificados.
Este comando es el equivalente a comprar el producto en la Store o mediante la API de compra.
La operación add con un juego, un durable, un lote (bundle) o un consumible administrado por el desarrollador que ya está concedido, no agrega otro derecho y la herramienta informa del derecho existente.
Para los productos consumibles administrados por la Store, se agrega una cantidad predeterminada de 1 al saldo del consumible con cada comando add.
Se puede especificar un valor de cantidad opcional para cambiar este valor predeterminado, pero el campo de cantidad solo puede usarse si se pasa un único productID con /p.
Esta opción es útil para los consumibles que conceden una cantidad mayor que 1 al comprarse.
Se admite /d para obtener más detalles.
La cantidad no puede verificarse con esta herramienta.
add con un producto de tipo lote concede todos los productos que incluye.
Si se especifica una cantidad y el lote incluye consumibles administrados por la Store, se asigna la misma cantidad a cada consumible.
No se admiten los productos de suscripción.
Salida de add
Ejemplos de add
Un solo derecho agregadodelete
deventitlementtool delete /e <testaccountemail> /s <sandboxid> /p <productid1> [<productid2> <productid3> ...] [/all] [/d]
Elimina uno o varios derechos especificados de la cuenta.
Si se especifica /all, intenta eliminar todos los derechos asociados a la cuenta y el sandbox.
Se muestra el estado Revoked al eliminar derechos concedidos por esta herramienta.
Se muestra el estado Refunded al eliminar derechos que se compraron de forma convencional a través del cliente de la Store o de la API del juego.
Se admite /d para obtener más detalles.
Salida de delete
Ejemplos de delete
catalog
deventitlementtool catalog /e <testaccountemail> /s <sandboxid> /p <productid1> [/m]
Muestra el conjunto de productos que puede vender el identificador de producto proporcionado; es decir, los productos complementarios secundarios y los productos con una relación de puede usar y vender con el productID en Partner Center.
Este comando es el equivalente de lo que devuelve XStoreQueryAssociatedProductsAsync.
Los productos no se devuelven cuando están configurados en Partner Center como disponibles pero no detectables en la Microsoft Store.
Opcionalmente, se puede especificar un mercado para recuperar los precios de ese mercado en particular.
El parámetro debe ser un código de región ISO de dos caracteres, por ejemplo, GB, CA, JP, ES, etc.
Salida de catalog
Ejemplo de catalog
Comentarios
Esta herramienta es estrictamente para su uso con cuentas de prueba de XBOX y para productos de sandbox. Su uso con cuentas y escenarios de venta al público está bloqueado. Hay un límite de operaciones add y delete por cuenta y día. Este límite se ajusta en función del uso observado. Para solicitar el aumento de los límites o enviar otros comentarios, póngase en contacto a través de su representante de cuentas de Microsoft.Documentación de referencia de la API
- XStore (contenido de la API)
- Funciones
- Estructuras