Version: 2023.1
언어: 한국어
UDP 레퍼런스
UDP SDK 데이터 컬렉션

UDP API

UDP API를 사용하면 UDP 콘솔에 바이너리 파일을 업로드할 수 있습니다. 이를 통해 CI 시스템을 사용하여 앱을 빌드하고 결과를 UDP로 직접 푸시할 수 있습니다. UDP 콘솔에서 게임 관리 및 퍼블리싱을 참조하십시오.

다음 파일 타입이 지원됩니다.

  • APK
  • OBB
  • AAB

API 구조

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
- patchObb
OBB 파일을 업로드하는 경우에만 이 쿼리 파라미터를 지정하면 됩니다.

폼 키

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

잘못된 조직 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 타입

잘못된 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}
UDP 레퍼런스
UDP SDK 데이터 컬렉션