UDP API를 사용하면 UDP 콘솔에 바이너리 파일을 업로드할 수 있습니다. 이를 통해 CI 시스템을 사용하여 앱을 빌드하고 결과를 UDP로 직접 푸시할 수 있습니다. UDP 콘솔에서 게임 관리 및 퍼블리싱을 참조하십시오.
다음 파일 타입이 지원됩니다.
API 구조는 다음과 같습니다: https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx[&obbType=xxxx]
아래 표에는 API 파라미터에 대한 설명이 나와 있습니다.
| 파라미터 | 설명 |
|---|---|
orgId |
바이너리 파일을 업로드할 게임의 조직 ID입니다. |
clientId |
바이너리 파일을 업로드할 게임의 클라이언트 ID입니다. |
token |
UDP 콘솔의 개발자 API 페이지에서 생성된 인증 토큰입니다. |
obbType |
업로드할 OBB 파일 타입입니다. 다음 값이 유효합니다.br/>- mainObb- patchObbOBB 파일을 업로드하는 경우에만 이 쿼리 파라미터를 지정하면 됩니다. |
UDP에 빌드를 업로드할 때 POST 메서드에서 폼 키를 사용하여 값을 지정할 수 있습니다. 값은 Game Information 탭의 Binary 섹션에 상응합니다.
아래 표에는 폼 키에 대한 설명이 나와 있습니다.
| 폼 키 | 설명 | 필수/선택 |
|---|---|---|
uploadFile |
업로드할 파일의 경로를 지정합니다. | 필수 |
whatsNew |
UDP 콘솔의 What’s New 필드 값을 설정합니다. | 선택 |
useGoogleService |
UDP 콘솔의 Does your game use Google Play Services? 필드 값을 설정합니다. | 선택 |
선택 키를 지정하지 않으면 UDP가 게임의 최신 버전의 값을 사용합니다.
잘못된 인증 토큰을 제공하면 상태 코드가 401인 오류 메시지가 표시됩니다.
{"errorCode":"NotAuthenticated","message":"not authenticated error","target":"","details":null}
잘못된 조직 ID나 잘못된 클라이언트 ID를 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"Invalid OrgId or ClientId","details":null}
잘못된 파일 타입을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid: please provide the right binary file(APK, AAB or OBB)","target":"file type","details":null}
잘못된 OBB 타입을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"obbType","details":null}
잘못된 콘텐츠 타입을 제공하면 상태 코드가 400인 오류 메시지가 표시됩니다.
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"content type","details":null}