API UDP позволяет загружать двоичные файлы в консоль UDP. Это позволяет использовать систему непрерывной интеграции для создания приложения и отправки результатов непосредственно в UDP. См. раздел Управление игрой и ее публикация на консоли UDP.
Поддерживаются следующие типы файлов:
- APK
- OBB
- AAB
Структура API
API имеет следующую структуру: https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx[&obbType=xxxx]
В таблице ниже описаны параметры API.
Параметры | Описание |
---|---|
orgId |
Идентификатор организации игры, для которой вы хотите загрузить бинарные файлы. |
clientId |
Идентификатор клиента игры, для которой вы хотите загрузить бинарные файлы. |
token |
Токен авторизации, созданный в консоли UDP на странице Developer API. |
obbType |
Тип файла OBB, который вы хотите загрузить. Допустимы следующие значения: - mainObb - patchObb Вам нужно только указать этот параметр запроса, когда вы загружаете файл OBB. |
Ключи формы
Вы можете использовать ключи формы в методе POST для указания значений при загрузке сборки в UDP. Значения соответствуют разделу «Двоичные данные» на вкладке «Информация об игре».
В таблице ниже описаны ключи формы.
Ключ формы | Описание | Обязательный/Необязательный |
---|---|---|
uploadFile |
Укажите путь к файлу для загрузки. | Mandatory |
whatsNew |
Установите значение поля Что нового в консоли UDP.. | Optional |
useGoogleService |
Установите значение поля Использует ли ваша игра сервисы Google Play? в консоли UDP.. | Optional |
Если вы не укажете дополнительные ключи, UDP использует значения последней версии вашей игры.
Распространенные сообщения об ошибках и коды ошибок
Недействительный токен аутентификации
Если вы укажете недействительный токен аутентификации, вы получите сообщение об ошибке с кодом состояния 401.
{"errorCode":"NotAuthenticated","message":"not authenticated error","target":"","details":null}
Неверный идентификатор организации или клиента
Если вы укажете недопустимый идентификатор организации или недопустимый идентификатор клиента, вы получите сообщение об ошибке с кодом состояния 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}