장소 게시에 대한 사용 가이드

장소 게시 API 는 Studio에서 Roblox에 게시하는 것과 유사한 기능을 제공하며, 추가 권한 제어 및 연속 릴리스 워크플로우의 자동화가 있습니다.이 API를 사용하여 경험의 기존 장소를 새 버전으로 업데이트하여 게시 워크플로를 자동화할 수 있습니다.예를 들어, GitHub 액션에서 이 API를 호출하여 통합 테스트가 성공적으로 완료된 후 바이너리 장소 파일을 Roblox에 자동으로 푸시할 수 있습니다.

제한

이 API는 HTTPS 요청만 지원합니다.
장소 게시 API는 특정 인스턴스 유형을 업데이트하지 않습니다.경험에 EditableImage , EditableMesh , PartOperation , SurfaceAppearance 또는 BaseWrap 인스턴스가 포함되어 있으면 수정 후 Studio에서 게시하십시오.

Roblox의 장소

Roblox의 경험은 한 곳의 시작 장소 를 사용자 경험 입력 지점으로 하고 다른 선택적 장소를 사용하여 사용자를 순간이동할 수 있습니다(순간이동 가능한 다른 장소).API를 사용하여 버전 제어로 시작 장소 또는 경험의 다른 장소를 게시할 수 있습니다.

경험의 기존 장소를 업데이트하려면 플레이스 장소 ID 와 경험의 유니버스 ID 가 필요합니다. 장소 ID 는 장소를 식별하고 우주 ID 는 경험을 식별합니다.경험에 한 플레이스있더라도 각각은 고유합니다.

플레이스게시

경험의 기존 장소를 게시하려면 장소 게시 API :

크리에이터 대시보드에 API 키 생성 . 다음 설정을 수행하십시오:
1. 우주 장소 를 액세스 권한 에 추가합니다.
2. 선택한 경험에 쓰기 작업을 추가합니다.
플레이스게시하려는 경험의 유니버스 ID 를 가져옵니다.
1. 탐색하여 크리에이터 대시보드로 이동합니다.
2. 업데이트하려는 장소와 함께 경험을 찾습니다.
3. 경험의 썸네일 섬네일이동하고 ⋯ 버튼을 클릭하고 우주 ID 복사 를 선택합니다.
업데이트하려는 장소의 장소 ID 를 가져옵니다.
1. 크리에이터 대시보드의 생성 페이지에 머무르고 대상 경험의 썸네일을 클릭하십시오.
2. 왼쪽 탐색 메뉴에서 장소 탭을 클릭하십시오.
3. 섬네일찾아 썸네일을 클릭하십시오.
4. 장소 ID는 리디렉션된 URL에 있습니다. 예를 들어, URL 에서 장소 ID는 입니다.

API 키를 x-api-key 헤더의 POST에 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 와 교체하고 게시하려는 경험의 장소를 배치합니다.

요청을 올바르게 보내면 다음 형식의 장소 버전 번호가 포함된 성공 응답 본체를 받습니다.
```
예시 응답 본문
{ "versionNumber": 7 }
```
(옵션) Studio 또는 크리에이터 대시보드에서 업로드를 확인합니다.

제한

Roblox의 장소

플레이스게시

이 페이지