Hướng dẫn sử dụng để xuất bản địa điểm | Tài liệu

API xuất bản địa điểm cung cấp chức năng tương tự như xuất bản lên Roblox trên Studio, với kiểm soát quyền truy cập bổ sung và tự động hóa trong quy trình phát hành liên tục. Bạn có thể sử dụng API này để cập nhật các địa điểm hiện có của một trò chơi lên phiên bản mới, điều này rất hữu ích để tự động hóa quy trình xuất bản của bạn. Ví dụ, bạn có thể gọi API này từ một hành động GitHub và tự động đẩy tệp địa điểm nhị phân lên Roblox sau khi kiểm tra tích hợp thành công.

Giới hạn

API này chỉ hỗ trợ các yêu cầu HTTPS.
API xuất bản địa điểm không cập nhật một số loại thể hiện nhất định. Nếu trò chơi của bạn chứa các thể hiện EditableImage, EditableMesh, PartOperation, SurfaceAppearance, hoặc BaseWrap, hãy xuất bản từ Studio sau khi chỉnh sửa chúng.

Các địa điểm trên Roblox

Các trò chơi trên Roblox có thể có nhiều địa điểm, với một địa điểm bắt đầu là điểm vào của người dùng trong trò chơi của bạn và các địa điểm khác tùy chọn mà bạn có thể teleport người dùng giữa các địa điểm. Bạn có thể sử dụng API để xuất bản hoặc địa điểm bắt đầu hoặc các địa điểm khác của trò chơi với kiểm soát phiên bản.

Trước khi bạn có thể cập nhật một địa điểm hiện có của một trò chơi, bạn cần Place ID của địa điểm đó và Universe ID của trò chơi. Place ID xác định địa điểm và Universe ID xác định trò chơi. Mỗi cái đều là duy nhất ngay cả khi trò chơi của bạn chỉ có một địa điểm.

Xuất bản một địa điểm

Để xuất bản một địa điểm hiện có của một trò chơi với Place Publishing API:

Tạo một API key trên Bảng điều khiển Creator. Hãy chắc chắn rằng bạn thực hiện các cài đặt sau:
1. Thêm universe-places vào Quyền truy cập.
2. Thêm thao tác Ghi vào trò chơi đã chọn của bạn.
Lấy Universe ID của trò chơi mà bạn muốn xuất bản địa điểm.
1. Điều hướng đến Bảng điều khiển Creator.
2. Tìm trò chơi có địa điểm mà bạn muốn cập nhật.
3. Di chuột qua hình thu nhỏ của trò chơi, nhấp vào nút ⋯, và chọn Sao chép Universe ID.
Lấy Place ID của địa điểm mà bạn muốn cập nhật.
1. Ở lại trang Tạo vật trên Bảng điều khiển Creator và nhấp vào hình thu nhỏ của trò chơi mục tiêu.
2. Trên menu điều hướng bên trái, nhấp vào tab Địa điểm.
3. Tìm địa điểm mà bạn muốn cập nhật và nhấp vào hình thu nhỏ của nó.
4. Place ID nằm trong URL đã chuyển hướng. Ví dụ, trong URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,, **Place ID** là 111111`.

Thêm API Key vào tiêu đề x-api-key của yêu cầu POST đến API. Hai yêu cầu ví dụ sau tham chiếu đến tệp địa điểm XML Roblox (.rbxlx) và tệp địa điểm nhị phân (.rbxl).

Yêu cầu Tệp Địa điểm 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

Yêu cầu Tệp Địa điểm Nhị phân
$ 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

Để chạy các lệnh, hãy thay thế {universeId} và {placeId} bằng Universe ID và Place ID thực tế của trò chơi và địa điểm mà bạn muốn xuất bản.

Nếu bạn gửi yêu cầu của mình đúng cách, bạn sẽ nhận được một phản hồi thành công với số phiên bản địa điểm theo định dạng sau:
```
Ví dụ Phản hồi Thành công
{ "versionNumber": 7 }
```
(Tùy chọn) Xác minh việc tải lên trong Studio hoặc trên Bảng điều khiển Creator.