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

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

La API de publicación de lugares ofrece funcionalidad similar a publicar en Roblox en Studio, con control de permisos adicional y automatización en el flujo de trabajo de lanzamiento continuo.Puedes usar esta API para actualizar los lugares existentes de una experiencia a una nueva versión, haciéndolo útil para automatizar tu flujo de trabajo de publicación.Por ejemplo, puedes llamar a esta API desde una acción de GitHub y tenerla automáticamente empujar un archivo de lugar binario a Roblox después de una prueba de integración exitosa.

Limitaciones

Lugares en Roblox

Las experiencias en Roblox pueden tener múltiples lugares, con un lugar de inicio como punto de entrada del usuario de tu experiencia y otros lugares opcionales que puedes teletransportar usuarios entre .Puedes usar la API para publicar el lugar de inicio o otros lugares de tu experiencia con control de versiones.

Antes de que puedas actualizar un lugar existente de una experiencia, necesitas el ID del lugar y la ID del universo de la experiencia .El ID de lugar identifica el lugar y el ID del universo identifica la experiencia.Cada uno es único incluso si tu experiencia solo tiene un lugar.

Publica un lugar

Para publicar un lugar existente de una experiencia con API de publicación de lugares :

  1. Crea una clave de API en el tablero de creación del creador . Asegúrate de realizar los siguientes ajustes:

    1. Añade lugares del universo a permisos de acceso .
    2. Añade Escribe operación a tu experiencia seleccionada.

  2. Obtén el ID del universo de la experiencia en la que quieres publicar el lugar.

    1. Navegue hasta el Panel del creador.

    2. Busca la experiencia con el lugar que quieres actualización.

    3. Pase el cursor sobre la miniatura de la experiencia, haga clic en el botón ⋯ y seleccione Copiar ID del universo .

  3. Obtenga el ID de lugar del lugar que desea actualización.

    1. Quédate en la página Creaciones en Panel del creador y haz clic en la miniatura de la experiencia objetivo.
    2. En el menú de navegación de la izquierda, haga clic en la pestaña Lugares .
    3. Encuentra el lugar que quieres actualizar y haz clic en su miniatura.
    4. El ID de lugar está en la URL redirigida. Por ejemplo, en la URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure, el ID de lugar es 111111.

  4. Añade la clave de API en el encabezado x-api-key de una solicitud POST a la API.Las siguientes dos solicitudes de ejemplo se refieren a un archivo de lugar XML de Roblox ( .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: <your-api-key>' \

    --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: <your-api-key>' \

    --header 'Content-Type: application/octet-stream' \

    --data-binary @/home/placefiles/place1.rbxl

    Para ejecutar los comandos, reemplace y con el ID del universo real y la ID del lugar de la experiencia y coloque el que desea publicar.

  5. Si envías tu solicitud correctamente, recibes 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) Verifique la subida en Studio o en tablero de creación.