Version: 1.3
语言 : 中文
UDP 参考
UDP SDK data collection

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 文件类型。以下值有效:
- mainObb
- patchObb
您只需要在上传 OBB 文件时指定该查询参数。

表单键

在将构建上传到 UDP 时,您可以在 POST 方法中使用表单键来指定值。这些值对应于“游戏信息”选项卡的“二进制文件”部分。

下表描述了表单键。

表单键 描述 必需/可选
uploadFile 指定要上传的文件的路径。 必需
whatsNew 在 UDP 控制台中设置新增功能字段的值。 可选
useGoogleService 在 UDP 控制台中设置您的游戏是否使用 Google Play 服务?字段的值。 可选

如果您不指定可选键,UDP 将使用您游戏的最新版本的值。

常见错误信息和错误代码

无效的身份验证令牌

如果您提供无效的身份验证令牌,您将收到状态代码为 401 的错误消息。

{"errorCode":"NotAuthenticated","message":"not authenticated error","target":"","details":null}

无效的组织 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 data collection