UDP API

Reference for the Unity Distribution Portal API, a service that shut down in February 2025.

읽는 시간 2분

최근 업데이트: 한 달 전

중요
UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. UDP 웹 콘솔 및 서비스에 대한 액세스는 이 날짜에 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 UDP 개요 페이지를 방문하십시오. 계정에 대한 질문이 있으면 Unity 고객 지원 팀에 티켓을 제출하십시오.

중요

UDP(유니티 퍼블리싱 포털)는 2025년 2월 17일에 종료됩니다. UDP 웹 콘솔 및 서비스에 대한 액세스는 이 날짜에 영구적으로 비활성화됩니다. 키스토어를 다운로드하고 게임을 앱 스토어에 직접 다시 퍼블리시하는 방법에 대한 지침을 보려면 UDP 개요 페이지를 방문하십시오. 계정에 대한 질문이 있으면 Unity 고객 지원 팀에 티켓을 제출하십시오.

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

다음 파일 유형이 지원됩니다.

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 파일 유형입니다. 다음 문자열 값은 유효합니다. - `mainObb` - `patchObb` OBB 파일을 업로드할 때만 이 쿼리 파라미터를 지정해야 합니다.

폼 키

POST 메서드에서 폼 키를 사용하여 빌드를 UDP에 업로드할 때 값을 지정할 수 있습니다. 값은 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}

Unity Engine

User Manual

Script Reference