地方發行的指南

放置發行 API 與 發布到 Roblox 在 Studio 中的功能相同，並且在持續釋放工作流程中增加額外的權限控制和自動化。您可以使用此 API 來更新現有的地點，將其更新到新版本，並且在 Roblox 雲端後續續導入成功的集成測試。

在 Roblox 上的地方

在 Roblox 上的體驗可以有多個地點，其中一個 開始地點 作為用戶體驗的入口點，並且可以選擇其他地點，以便用戶可以在 傳送用戶之間 。 您可以使用 API 發布開始地點或其他地點，並且可以使用版本控制來發布體驗。

在更新現有地點之前，您需要取得該空間點的 地點 ID 和體驗的 宇宙 ID 。 地點 ID 會識別該地點和體驗的 2>宇宙 ID2> 。 每個地點都獨一無二，即使您的體驗只有一個空間。

發布地點

要發布體驗中的現有地點使用 地方發布 API :

1. 在創作者面板上建立 API 鑰匙。請確認您執行了以下設定：

   1. 將 宇宙位置 添加到 存取權限 。
   2. 將 寫入 操作添加到您選擇的體驗。

2. 取得您想要發布地空間的體驗的 宇宙 ID 。

   1. 導航到創作者控制板。

   2. 找到你想要更新的地方。

   3. 將鼠標擺置在目標體驗的預覽上，然後按一下 ⋯ 按鈕以顯示選項清單，然後從清單中選擇 複製宇宙 ID 。

      

3. 取得您想要更新的地方 地方 ID 。

   1. 保持在 創作 頁面上，在 創作者面板 上，並按一下目標體驗的預覽。
   2. 在左側導航選單中，按一下 地方 標籤。
   3. 找到您想要更新的位置，然後單擊其縮圖。
   4. 地方 ID 在重新導航的 URL 中。例如，在 https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure 中， 地方 ID 是 1>1111111>。

4. 將 API 鑰匙添加到 x-api-key 標題的 POST 請求的 API 。 以下兩個示例請求參考 Roblox XML 位置 ( .rbxlx ) 和二進位置文件 ( 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> 的體驗和地方，並發布您想要發發佈的體驗和地方。

5. 如果您正確發送您的請求，您將收到一個成功的回應體，其中包含位置版本號碼：

   範例反應體
   { "versionNumber": 7 }

6. (可選) 在 Studio 或 創作者控制板 上確認上傳。