地點發佈使用指南

地點發佈 API 提供的功能與 在 Studio 中發佈到 Roblox 相似，並具備額外的權限控制和持續發佈工作流程的自動化。您可以使用此 API 將遊戲的現有地點更新到新版本，非常適合自動化您的發佈工作流程。例如，您可以在 GitHub 行動中調用此 API，並在成功的整合測試後自動將二進位地點文件推送到 Roblox。

限制

• 此 API 僅支持 HTTPS 請求。
• 地點發佈 API 不會更新某些實例類型。如果您的遊戲包含 EditableImage、EditableMesh、PartOperation、SurfaceAppearance 或 BaseWrap 實例，請在修改後從 Studio 發佈。

Roblox 上的地點

Roblox 遊戲可以有多個地點，其中一個起始地點作為用戶進入您遊戲的入口，還可以有其他可選的地點，您可以在這些地點之間傳送用戶。您可以使用 API 以版本控制的方式發佈遊戲的起始地點或其他地點。

在您可以更新遊戲的現有地點之前，您需要該地點的地點 ID和遊戲的宇宙 ID。地點 ID用於識別地點，而宇宙 ID用於識別遊戲。即使您的遊戲只有一個地點，每個 ID 也是唯一的。

發佈地點

要使用 地點發佈 API 發佈遊戲的現有地點：

1. 在創作者儀表板上創建 API 密鑰。確保您執行以下設置：

   1. 將 universe-places 添加到訪問權限中。
   2. 將 Write 操作添加到您選定的遊戲中。

2. 獲取您要發佈地點的遊戲的宇宙 ID。

   1. 前往 創作者儀表板。

   2. 找到包含您要更新的地點的遊戲。

   3. 將鼠標懸停在遊戲縮略圖上，單擊 ⋯ 按鈕，然後選擇 複製宇宙 ID。

      

3. 獲取您要更新的地點的地點 ID。

   1. 保持在創作者儀表板的 創作 頁面上，然後單擊目標遊戲的縮略圖。
   2. 在左側導航菜單中，單擊 地點 標籤。
   3. 找到您要更新的地點，然後單擊其縮略圖。
   4. 地點 ID 位於重定向的 URL 中。例如，在 URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,中，**地點 ID** 為111111`。

4. 在對 API 的 POST 請求的 x-api-key 標頭中添加 API 密鑰。以下兩個示例請求引用了 Roblox XML 地點文件（.rbxlx）和二進位地點文件（.rbxl）。

   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 和 地點 ID。

5. 如果您正確發送請求，將收到一個成功的響應主體，其中包含以下格式的地點版本號：

   示例響應主體
   { "versionNumber": 7 }

6. （可選）在 Studio 或 創作者儀表板 中驗證上傳。