playtest leen
los playtests de un juego en Partner Center, y los crean, actualizan, publican y eliminan. create,
update, publish y delete preguntan antes de hacer un cambio.
create, update, publish y delete son experimentales: sus opciones y su salida pueden cambiar
o quitarse. Consulta Comandos experimentales.
Comandos
Argumentos y opciones
Ejemplos
Enumera playtests, obtén uno y compara dos:Lectura de playtests
playtest list escribe una matriz playtests. Su tabla tiene las columnas PLAYTEST ID, NAME, STATUS, TYPE,
START y END. Un extracto:
playtest get escribe el playtest tal como lo devuelve el servicio. etag es la versión que se debe pasar a
update --if-match, y audiences.audienceIds enumera las audiencias que pueden unirse. Su tabla tiene
filas FIELD y VALUE.
playtest diff escribe hasDiffData, current y compared. Cuando hasDiffData es false,
no hay nada que comparar y se omite compared. Su tabla muestra solo los campos que
difieren, en las columnas FIELD, CURRENT y COMPARED. Las imágenes no se comparan.
Creación de un playtest
playtest create crea un playtest privado en borrador y lo escribe como lo hace playtest get. Volver a ejecutarlo
crea otro playtest; quita uno que no quieras con
playtest delete.
Cada creación envía una clave de idempotencia, un GUID nuevo a menos que pases --idempotency-key. Una creación que
repite una clave devuelve el playtest que creó esa clave e ignora las opciones que difieran.
Cuando el resultado es desconocido, por ejemplo después de un tiempo de espera agotado, el comando sale con 3 e imprime un comando
que reintenta con la misma clave:
--idempotency-key y esa clave. Si el reintento se rechaza, por ejemplo porque la fecha de finalización ya ha pasado,
comprueba playtest list antes de crear el playtest con una clave nueva.
Paquetes
Un playtest puede tener un paquete de PC y un paquete de consola. Elige un paquete que esté listo para un playtest enxbox package list y pasa su id a la opción
de su plataforma:
update, una opción de paquete que omites conserva su paquete, un identificador nuevo lo reemplaza y ""
lo quita:
Actualización de un playtest
playtest update cambia solo las opciones que pasas y necesita al menos una. Escribe el playtest
actualizado como lo hace playtest get. Se conserva el arte del juego configurado en Partner Center; el resto del arte vinculado
al playtest se reemplaza por un marcador de posición.
Para evitar sobrescribir el cambio de otra persona, pasa el etag de playtest get en --if-match.
Las comillas dobles que lo rodean son opcionales, y se rechazan *, los etags débiles (W/) y las listas de etags:
3. Comprueba el playtest con playtest get antes
de reintentar.
Elección de audiencias
Una audiencia es un grupo de jugadores, como evaluadores, que el vendedor administra en Partner Center. Pasa unid de audience list a --audience-id, y repítelo para agregar más:
--audience-id, create crea un playtest sin audiencias y update las conserva. En
update, los identificadores que pasas reemplazan todas las audiencias del playtest. Para quitar todas las audiencias, pasa
"" solo:
"" no se puede combinar con identificadores de audiencia, y create lo rechaza. Un playtest necesita al menos una
audiencia para poder publicarse.
Publicación de un playtest
Si el juego usa servicios XBOX, prepara su configuración y su embargo antes de publicar. Consulta Usar servicios XBOX en un playtest.412 y
no cambia nada.
Antes de pedirte confirmación, el comando comprueba la configuración de servicios XBOX del juego, por ejemplo si
su fecha de embargo es posterior a la fecha de finalización del playtest, y enumera en stderr todo lo que se debe revisar. Estas
comprobaciones solo son orientativas; --confirm publica sin preguntar.
A continuación, el servicio ejecuta sus propias comprobaciones. Cuando una bloquea la publicación, no se pone nada en cola, y el
comando enumera cada comprobación en stderr y sale con 1. Corrige los errores y vuelve a publicar. Un playtest
bloqueado por falta de clasificaciones por edades necesita que se complete el cuestionario de clasificación por edades en Partner Center.
Una vez que la publicación está en cola, el comando espera hasta que el playtest esté en estado Scheduled, Live o
PublishFailed, y lo escribe como lo hace playtest get. Ctrl+C deja de esperar, pero la publicación
continúa. Con --no-wait, el comando escribe publishJobId y cualquier warnings en cuanto la
publicación está en cola; haz su seguimiento con playtest get.
Eliminación de un playtest
playtest delete elimina la versión del playtest que lee primero. Espera hasta que el playtest
esté en estado Deleted o haya desaparecido y, a continuación, escribe la respuesta del servicio, con status. Ctrl+C deja de esperar, pero
la eliminación continúa. Con --no-wait, escribe la respuesta en cuanto la eliminación está en cola.
Después de un 412, es posible que la eliminación ya esté en cola, así que espera un minuto y comprueba con playtest get
antes de volver a eliminar.
Fechas
--start y --end aceptan fechas y horas ISO 8601, como 2026-11-01T09:00:00-07:00 o
2026-11-01T16:00:00Z. Una fecha sin hora significa medianoche UTC, y una hora sin desplazamiento está en
UTC. Cuando una actualización pasa solo una fecha, el servicio la comprueba con la otra fecha del playtest.
Errores
Los errores van a stderr y salen con1, a menos que las tablas de códigos de salida anteriores indiquen lo contrario. create y
update salen con 3 cuando su resultado es desconocido. Un error que devuelve el servicio incluye su estado
HTTP, y --verbose agrega la respuesta del servicio, cuyo campo code se muestra aquí:
Para otros errores, el comando muestra el mensaje del servicio. Un 429 significa que enviaste demasiadas
solicitudes; espera el tiempo que indique el mensaje antes de volver a intentarlo.
