장소 게시에 대한 사용자 가이드 | 설명서

장소 게시 API는 스튜디오의 게시 워크플로에서 게시를 Roblox와 동일한 기능을 수행하지만 추가 권한 제어 및 자동화를 포함하여 연속 릴리스 워크플로에서 작동합니다. 이 API를 사용하여 경험의 기존 장소

이 API는 HTTPS 요청만 지원합니다.

Roblox에 있는 장소

Roblox의 체험은 여러 장소를 가질 수 있으며, 하나의 시작 장소를 사용자 경험의 사용자 입장 지점으로 사용하고 옵션인 다른 장소를 사용자가 텔레포트할 수 있습니다. API를 사용하여 시작 장소 또는 다른 장소를 버전 제어로 사용자 간에 게시할 수 있습니다.

경험의 기존 장소를 업데이트하려면 플레이스장소 ID 및 경험의 유니버스 ID가 필요합니다. 장소 ID는 장소를 식별하고 경험의 2>유니버스 ID2>는 경험을 식별합니다. 각각은 경험에 하나의 플레이스있는 경우에도 고유합

장소 게시

현재 장소를 장소 게시 API로 게시하려면:

API 키 생성 대시보드에서 크리에이터 대시보드 에 대해 다음 설정을 수행하세요.
1. Access Permissions 에 universe-places 를 추가합니다.
2. 선택한 경험에 쓰기 작업을 추가합니다.
플레이스게시하려는 경험의 유니버스 ID 를 얻으십시오.
1. 크리에이터 대시보드로 moves.
2. 업데이트하려는 장소와 관련된 경험을 찾습니다.
3. 대상 경험의 썸네일 위로 마우스를 이동하고 ⋯ 버튼을 클릭하여 옵션 목록을 표시한 다음 복사 목록을 선택합니다.
업데이트할 장소의 장소 ID 를 가져옵니다.
1. 크리에이터 대시보드의 생성 페이지에 있고 대상 경험의 썸네일을 클릭하십시오.
2. 왼쪽 탐색 메뉴에서 장소를 탭합니다.
3. 업데이트하려는 위치를 찾아 썸네일을 클릭하십시오.
4. 이 리디렉션된 URL에는 장소 ID가 있습니다. 예를 들어, https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure 의 경우, 장소 ID는 1>1111111>입니다.

API 키를 x-api-key 헤더의 POST 요청에 추가하십시오. 다음 두 예 요청은 Roblox XML 장소 파일(.rbxlx )과 바이너리 장소 파일(2>.rbxl2> )을 참조합니다.

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}를 교체하십시오.

요청을 올바르게 보낸 경우 다음과 같은 장소 버전 번호가 포함된 성공 응답 바디를 받습니다.
```
응답 본문 예시
{ "versionNumber": 7 }
```
(선택사항) Studio 또는 크리에이터 대시보드 에서 업로드를 확인합니다.