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í.

Publicar API ] cumple con la misma funcionalidad que Publicar en Roblox en Studio más el control de permisos y automatización adicional en el flujo de trabajo de lanzamiento continuo. Puede usar esta API para actualizar los lugares existentes de una experiencia a una nueva versión, haciéndolo útil para automatizar su flujo de trabajo de publicación. Por ejemplo, puede llamar esta API desde una acción de GitHub, y

Lugares en Roblox

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

Antes de que pueda actualizar un lugar existente de una experiencia, necesita el ID del Lugar del lugar y el Universo ID del experimento . El ID del Lugar del lugar identifica el lugar y el 2> Universo ID del experimento2> identifica la experiencia. Cada uno es único incluso si su experiencia tiene solo un lugar.

Publicar un lugar

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

  1. Crear una clave de API en el Panel de control del creador . Asegúrese de realizar las siguientes configuraciones:

  2. Añadir lugares del universo a permisos de acceso .

  3. Agregue la operación Escriba a su experiencia seleccionada.

  4. Obtén el ID del Universo de la experiencia en la que quieres publicar el lugar.

    1. Navegar al Panel del Creador .

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

    3. Pase el mouse sobre la miniatura de la experiencia objetivo y haga clic en el botón ⋯ para mostrar una lista de opciones, luego seleccione Copiar ID del Universo de la lista.

      Copy Universe ID option from Creator Dashboard

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

    1. Manténgase en la página Creaciones en Dash y haga clic en la miniatura de la experiencia objetivo.
    2. En el menú de navegación de la izquierda, haz 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 1> 1111111> .

  6. Añade la llave de API en el x-api-key encabezado de una solicitud POST a la API. Las siguientes dos solicitudes de ejemplo hacen referencia a un archivo de lugar Roblox XML ( .rbxlx ) y un archivo de lugar binario ( 2> .rbxl2> ).

    Solicitud de archivo de lugar de 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 lugar de archivo 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 {universeId} y {placeId} con el actual ID del Universo y 1>Lugar ID1> de la experiencia y el lugar que desea publicar.

  7. 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 }

  8. (Opcional) Verifique el envío en Studio o en Panel de Creator .