Guía de uso para la publicación de lugares

La API de publicación de lugares ofrece una funcionalidad similar a la de publicar en Roblox en Studio, con un control de permisos adicional y automatización en un flujo de trabajo de lanzamiento continuo. Puedes usar esta API para actualizar lugares existentes de un juego a una nueva versión, lo que la hace útil para automatizar tu flujo de trabajo de publicación. Por ejemplo, puedes llamar a esta API desde una acción de GitHub y hacer que automáticamente envíe un archivo de lugar binario a Roblox después de la integración de pruebas exitosa.

Limitaciones

• Esta API solo admite solicitudes HTTPS.
• La API de publicación de lugares no actualiza ciertos tipos de instancias. Si tu juego contiene instancias de EditableImage, EditableMesh, PartOperation, SurfaceAppearance o BaseWrap, publica desde Studio después de modificarlas.

Lugares en Roblox

Los juegos en Roblox pueden tener múltiples lugares, con un lugar de inicio como el punto de entrada del usuario a tu juego y otros lugares opcionales entre los que puedes teletransportar usuarios. Puedes usar la API para publicar tanto el lugar de inicio como otros lugares de tu juego con control de versiones.

Antes de que puedas actualizar un lugar existente de un juego, necesitas el ID del Lugar y el ID del Universo del juego. El ID del Lugar identifica el lugar y el ID del Universo identifica el juego. Cada uno es único incluso si tu juego tiene solo un lugar.

Publicar un lugar

Para publicar un lugar existente de un juego usando la API de Publicación de Lugares:

1. Crea una clave API en el Tablero de Creadores. Asegúrate de realizar los siguientes ajustes:

   1. Agrega universe-places a Permisos de Acceso.
   2. Agrega la operación Escribir a tu juego seleccionado.

2. Obtén el ID del Universo del juego en el que deseas publicar el lugar.

   1. Navega al Tablero de Creadores.

   2. Encuentra el juego con el lugar que deseas actualizar.

   3. Pasa el cursor sobre la miniatura del juego, haz clic en el botón ⋯ y selecciona Copiar ID del Universo.

      

3. Obtén el ID del Lugar del lugar que deseas actualizar.

   1. Permanece en la página de Creaciones en el Tablero de Creadores y haz clic en la miniatura del juego objetivo.
   2. En el menú de navegación de la izquierda, haz clic en la pestaña Lugares.
   3. Encuentra el lugar que deseas actualizar y haz clic en su miniatura.
   4. El ID del Lugar está en la URL redirigida. Por ejemplo, en la URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,el **ID del Lugar** es111111`.

4. Agrega la clave API en el encabezado x-api-key de una solicitud POST a la API. Las siguientes dos solicitudes de ejemplo hacen referencia a un archivo de lugar XML (.rbxlx) y a un archivo de lugar binario (.rbxl).

   Solicitud de Archivo de Lugar XML
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <tu-clave-api>' \
   --header 'Content-Type: application/xml' \
   --data-binary @/home/placefiles/place1.rbxlx

   Solicitud de Archivo de Lugar Binario
   $ curl --verbose --location POST 'https://apis.roblox.com/universes/v1/{universeId}/places/{placeId}/versions?versionType=Published' \
   --header 'x-api-key: <tu-clave-api>' \
   --header 'Content-Type: application/octet-stream' \
   --data-binary @/home/placefiles/place1.rbxl

   Para ejecutar los comandos, reemplaza {universeId} y {placeId} con el ID del Universo y el ID del Lugar reales del juego y lugar que deseas publicar.

5. Si envías tu solicitud correctamente, recibirás un cuerpo de respuesta de éxito con el número de versión del lugar en el siguiente formato:

   Cuerpo de Respuesta de Ejemplo
   { "versionNumber": 7 }

6. (Opcional) Verifica la carga en Studio o en el Tablero de Creadores.