地方发布的使用手册

放置发布 API 实现与 发布到 Roblox 在 Studio 中的相同功能，还有额外的权限控制和自动化在持续释放工作流程中。您可以使用此 API 更新体验中的现有地点到新版本，使它有助于自动化您的发布工作流程。例如您可以从 GitHub 操动作中调用此 API，并且它会

在 Roblox 上放置

在 Roblox 上的体验可以有多个地点，其中一个 开始地点 作为用户体验的入口点，并且可以选择其他地点，您可以使用 API 发布体验的开始地点或其他地点，具有版本控制的。

在您更新现有体验的地方之前，您需要场景方的 位置 ID 和体验的 宇宙 ID 。 位置 ID 确定地方和体验的 2>宇宙 ID2> 。 每个都是独特的，即使您的体验只有一个场景。

发布地点

要发布使用 地方发布 API 发布的体验地点：

1. 在创建者仪表板上创建 API 钥匙。请确保您执行以下设置：

2. 将 宇宙位置 添加到 访问权限 。

3. 在您选择的体验添加 写入 操作。

4. 获取您想要发布该场景的体验的 宇宙ID 。

   1. 导航到创建者仪表板。

   2. 找到您想要更新的地方的体验。

   3. 将鼠标悬停在目标体验的缩略图上，然后单击 ⋯ 按钮显示选项列表，然后从列表中选择 复制宇宙ID 。

      

5. 获取您想要更新的地方的 地方 ID 。

   1. 在创作页面上，在 创建者仪表板 上，单击目标体验的缩略图。
   2. 在左侧导航菜单中，单击 地方 选项卡。
   3. 找到您想要更新的地方，然后单击其缩略图。
   4. 地方ID 在重新定向的 URL 中。例如，在 https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure 中， 地方ID 是 1>1111111> .

6. 在 POST 请求的 API 头中添加 API 钥匙。以下两个示例请求的示例引用 Roblox XML 位置文件 ( .rbxlx ) 和 binary 位置文件 ( 1>.rbxl1> )。

   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

   二进制位置文件请求
   $ 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

   要运行命令，请将 {universeId} 和 {placeId} 替换为实际的 宇宙ID 和 1>地方ID1> 体验和地方。

7. 如果您正确发送您的请求，您将收到以下格式中的成功响应体：

   示例响应体
   { "versionNumber": 7 }

8. (可选) 验证上传在 Studio 或在 创建者仪表板 上。