장소 게시를 위한 사용 안내서

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

장소 게시 API는 Studio에서 Roblox에 게시하는 것과 유사한 기능을 제공하며, 추가적인 권한 제어와 지속적인 릴리스 워크플로우의 자동화 기능을 갖추고 있습니다. 이 API를 사용하여 게임의 기존 장소를 새로운 버전으로 업데이트할 수 있으므로, 게시 워크플로우를 자동화하는 데 유용합니다. 예를 들어, GitHub 액션에서 이 API를 호출하면 성공적인 통합 테스트 후에 이진 장소 파일을 Roblox로 자동으로 푸시할 수 있습니다.

제한 사항

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

Roblox의 장소

Roblox의 게임은 시작 장소를 사용자 진입점으로 하여 여러 장소를 가질 수 있으며, 선택적으로 사용자가 텔레포트 할 수 있는 다른 장소들을 포함할 수 있습니다. API를 사용하여 시작 장소 또는 게임의 다른 장소를 버전 관리로 게시할 수 있습니다.

게임의 기존 장소를 업데이트하려면 해당 장소의 Place ID와 게임의 Universe ID가 필요합니다. Place ID는 장소를 식별하고, Universe ID는 게임을 식별합니다. 각 ID는 고유하며, 게임에 단 하나의 장소만 있을 경우에도 마찬가지입니다.

장소 게시

장소 게시 API를 사용하여 게임의 기존 장소를 게시하려면:

Creator Dashboard에서 API 키를 생성합니다. 다음 설정을 수행해야 합니다:
1. Access Permissions에 universe-places를 추가합니다.
2. 선택한 게임에 Write 작업을 추가합니다.
장소를 게시할 게임의 Universe ID를 가져옵니다.
1. Creator Dashboard로 이동합니다.
2. 업데이트할 장소가 있는 게임을 찾습니다.
3. 게임의 썸네일 위에 마우스를 가져가고 ⋯ 버튼을 클릭한 다음 Copy Universe ID를 선택합니다.
업데이트할 장소의 Place ID를 가져옵니다.
1. Creator Dashboard의 Creations 페이지에 남아 있는 상태에서 타겟 게임의 썸네일을 클릭합니다.
2. 왼쪽 탐색 메뉴에서 Places 탭을 클릭합니다.
3. 업데이트할 장소를 찾아서 썸네일을 클릭합니다.
4. Place ID는 리디렉션된 URL에 있습니다. 예를 들어, URL https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure,에서 **Place ID**는 111111`입니다.

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}를 실제 Universe ID 및 Place ID로 대체하십시오.

요청을 올바르게 전송하면 다음 형식으로 장소 버전 번호가 포함된 성공 응답 본문을 받게 됩니다:
```
예제 응답 본문
{ "versionNumber": 7 }
```
(선택 사항) Studio 또는 Creator Dashboard에서 업로드를 확인합니다.

한국어