此接口用于更新已创建的测试版本。
在架的测试版本不允许调用此接口。
| 承载协议 | HTTPS PUT |
|---|---|
| 接口方向 | 服务商服务器 -> 华为服务器 |
| 接口URL | https://connect-api.cloud.huawei.com/api/publish/v2/test/app/version |
| 数据格式 | 请求:Content-Type: application/json 响应:Content-Type: application/json |
| 参数 | 必选(M)/可选(O) | 类型 | 说明 |
|---|---|---|---|
| client_id | M | String | API客户端ID。 创建第三方平台成功后系统自动分配的客户端ID,可在第三方管理平台“开发配置 > 开发资料设置”页面中获取,详情请参见获取平台访问凭据。 |
| Authorization | M | String | 认证信息。 格式为“Authorization: Bearer ${access_token}”。 其中,${access_token}为获取平台级Token中获取的access_token。 |
请求Body中使用JSON格式携带需要更新的测试版本信息,参数如下表所示。
测试信息默认继承全网版本信息或最近一个测试版本填写的信息。如需调整,请在当前测试版本提交前重新审视并修改,测试信息配置不影响全网版本的应用信息。
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| versionId | M | String(32) | 需要更新的测试版本ID。 |
| pkgId | O | String(32) | 需要上传的软件包ID。 说明: 请确保上传的软件包是正常状态,即确认查询软件包编译状态接口中的响应参数successStatus为0。 |
| languages | O | List<AppLanguage> | 版本多语言本地化信息,数组长度不超过100。 |
| deviceTypes | O | List<DeviceTypeInfo> | 版本的设备类型信息,数组长度不超过6。 |
| distCountryList | O | String(1024) | 版本发布国家的国家码,多个国家以英文逗号分隔,例如:“CN,DE,MC”。如果取值为“OTHER”,表示当App Gallery支持的国家或地区列表中新增某个国家或地区时,版本将自动分发到新增的国家和地区。国家码列表请参见国家码。 注意: 取值不能只包含OTHER。仅公开测试支持填写此字段。 |
| extInfo | O | 版本扩展信息。 | |
| openTestInfo | O | 测试版本信息,包含测试版本开始时间和结束时间。 | |
| packagePermissionIntroVideoList | O | 软件包权限使用场景说明视频。 数组长度不超过100。 | |
| versionVocReq | O | List<VersionVocReq> | 应用版本已解决问题。如果在应用版本更新时某些问题已经解决,可以将这些问题提交审核,工单平台验证通过后会关闭工单。 数组长度不超过1000。 注意: 仅公开测试支持填写此字段。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| language | M | String(20) | 应用支持的语言。 |
| appName | O | String(255) | 应用名称。 不少于2个字符,否则应用信息不完整。 |
| appDesc | M | String(8000) | 对应语言的应用介绍。 不少于2个字符,否则应用信息不完整。 |
| briefInfo | O | String(256) | 应用简介,新增应用一句话介绍。 不少于1个字符,否则应用信息不完整。 |
| newFeatures | M | String(1024) | 测试说明,描述测试版本的重点特性。 |
| formalVersionNewFeatures | O | String(1024) | 描述正式版本的重点特性。 当为测试版本时候,该字段表示后续转成正式版本的新版本特性描述。 |
| deviceMaterials | O | List<DeviceMaterial> | 设备类型相关的素材。素材的格式请参考应用素材规范。 数组长度不超过6。 注意: 接口不校验素材的格式(尺寸、分辨率、文件后缀等),请开发者自行保证素材格式的准确性,以免影响素材最终的呈现效果。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| deviceType | M | Integer | 设备类型。 取值范围:
说明: 其他设备类型暂未开放。 |
| appIcon | O | String(300) | 应用图标下载地址(不少于1个字符,否则应用信息不完整)。 注意: 作为输入参数是相对地址,作为查询结果是完整地址。 |
| screenShots | O | List<String(300)> | 应用截屏地址(不少于1个字符,否则应用信息不完整)。 多个地址以英文逗号隔开,最多不超过10个地址,最少不少于3个地址。 注意: 作为输入参数是相对地址,作为查询结果是完整地址。 |
| showType | O | Integer | 截图展现方式。 取值范围:
|
| promoGraphics | O | List<String(300)> | 宣传图片地址。 多个地址以英文逗号隔开,最多不超过10个地址。 注意: 作为输入参数是相对地址,作为查询结果是完整地址。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| deviceType | M | Integer | 设备类型。 取值范围:
|
| appAdapters | O | String | 适配设备类型。
|
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| testUserName | O | String(128) | 应用审核信息的测试账号。 注意: 仅公开测试支持填写此字段。 |
| testUserPassword | O | String(128) | 应用审核信息的测试用户密码。 注意: 仅公开测试支持填写此字段。 |
| appRemark | O | String(300) | 应用审核信息的备注。 注意: 仅公开测试支持填写此字段。 |
| isSignedCommitment | O | Integer(32) | 是否签署合规承诺函 默认空为未签署 ,已签署为1,目前只有元服务服务签署。 注意: 仅公开测试支持填写此字段。 |
| registeredIdType | O | Integer(32) | 备案证件类型。
注意: 仅公开测试支持填写此字段。 |
| registeredIdNumber | O | String(64) | 备案证件号码。
注意: 仅公开测试支持填写此字段。 |
| privacyAgreementId | O | String(32) | 隐私协议ID。 注意: 仅公开测试支持填写此字段。 |
| userAgreementUrl | O | String(512) | 用户协议URL。 注意: 仅公开测试支持填写此字段。 |
| userAgreementIds | O | List<String(32)> | 用户协议ID列表。当userAgreementUrl和userAgreementIds同时传值时,以userAgreementIds值为准。 数组长度不超过5。 注意: 仅公开测试支持填写此字段。 |
| privacyPolicy | O | String(512) | 隐私政策网址。 |
| privacyRightsUrl | O | String(256) | 隐私权利网址。 |
| encrypted | O | Integer(32) | 包是否加密。 取值范围:
默认值:1 |
| isAiGenerate | O | Integer(32) | 是否涉及AI生成合成服务。 取值范围:
注意: 仅公开测试支持填写此字段。 |
| aiTypes | O | List<Integer(32)> | 涉及的AI生成合成服务类型。 注意: 仅公开测试支持填写此字段。 取值范围:
说明: isAiGenerate取值为1(涉及)时,此参数必填。 |
| appReviewPhoneInfo | O | 应用负责人的手机号信息。用于沟通审核问题。 注意: 仅公开测试支持填写此字段。 | |
| appReviewEmailInfo | O | 应用负责人的邮箱账号信息。用于接收上架审核结果,应用整改或下架通知。 注意: 仅公开测试支持填写此字段。 | |
| appReviewName | O | String(256) | 应用负责人的姓名。 注意: 仅公开测试支持填写此字段。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| account | O | String(500) | 应用负责人的手机号码或者邮箱账号。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| startTime | M | Integer(64) | 测试版本开始时间,UTC时间。 |
| endTime | M | Integer(64) | 测试版本结束时间,UTC时间。 |
| testDesc | O | String(50) | 测试版本描述。 |
| testTaskInfo | O | 测试发布信息。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| groupInfos | M | 测试用户信息。 注意: 公开测试不支持修改。 | |
| needShareLink | O | Integer | 是否需要生成分享链接。 取值范围:
|
| publicTestInstallLimit | O | Integer | 公开测试安装次数上限。当前默认是10万次。 注意: 仅公开测试支持填写此字段。 |
| displayArea | O | String(32) | 展示区域。 取值范围:
说明:
|
| needNotify | O | Integer(32) | 是否向用户发送测试通知。 取值范围:
默认值:1 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| groupId | O | String(32) | 测试群组ID。 |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| lang | M | String(8) | 语言种类,取值参见语言类型。 |
| permissionName | M | String(512) | 权限标记字符串。 |
| deviceType | M | Integer(32) | 设备类型。 取值范围:
|
| objectId | M | String(512) | 文件在OBS上的objectId。(先调用获取上传文件地址接口,然后调用上传文件接口上传文件,最后得到获取上传文件地址接口返回的objectId。) |
| 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| versionId | M | String(32) | 版本号。 |
| packageId | M | String(32) | 软件包ID。 |
| vocId | M | String(32) | 问题工单ID。 |
PUT /api/publish/v2/test/app/version?appId=6917********65 HTTP/1.1
Host: connect-api.cloud.huawei.com
client_id: 4141******68
Content-Type: application/json
Authorization: Bearer *******
{
"versionId": "1425*********60",
"pkgId": "1426********56",
"languages": [
{
"language": "zh-CN",
"appName": "应用名称demo",
"appDesc": "应用介绍demo",
"briefInfo": "应用简介demo",
"newFeatures": "测试说明demo",
"deviceMaterials": [
{
"deviceType" : 4,
"showType" : 1,
"appIcon" : "CN/2024072501/**************************d505c9.png",
"screenShots" : ["CN/2024072502/**************************77ff8e.png", "CN/2024072502/**************************de7e9a.png", "CN/2024072502/**************************acaaea.png"]
},
{
"deviceType" : 5,
"showType" : 1,
"appIcon" : "CN/2024072501/**************************37fd1b.png",
"screenShots" : ["CN/2024072502/**************************32d622.png", "CN/2024072502/**************************5d3050.png", "CN/2024072502/**************************d6eedc.png", "CN/2024072502/**************************a9a829.png"]
},
{
"deviceType" : 12,
"showType" : 1,
"appIcon" : "CN/2024072501/**************************1a8716.png",
"screenShots" : ["CN/2024072502/**************************949260.png", "CN/2024072502/**************************e71f72.png", "CN/2024072502/**************************572790.png", "CN/2024072502/**************************5c904e.png", "CN/2024072502/**************************6b7bff.png"],
"promoGraphics" : ["CN/2024072502/**************************f48560.png", "CN/2024072502/**************************fc084b.png", "CN/2024072502/**************************a3d4a5.PNG"]
}
]
}
],
"deviceTypes": [
{
"deviceType": 4,
"appAdapters": ""
}
],
"distCountryList": "CN",
"extInfo": {
"userAgreementIds": [
"12***************89",
"23***************78",
"34***************67"
],
"privacyPolicy": "http://**********",
"privacyRightsUrl": "http://*********"
},
"openTestInfo": {
"startTime": 1716*****000,
"endTime": 1717*****000,
"testDesc": "版本描述demo",
"testTaskInfo": {
"groupInfos": [
{
"groupId": "761e*****************008"
}
],
"needShareLink": 0,
"displayArea": "1",
"needNotify": 0
}
},
"packagePermissionIntroVideoList": [
{
"lang": "zh-CN",
"permissionName": "*****",
"deviceType": 4,
"objectId": "CN/2024052102/********.app"
}
],
"versionVocReq": [
{
"versionId": "10*****528",
"packageId": "1573*******5952",
"vocId": "18******24"
}
]
} | 参数名称 | 必选(M)/可选(O) | 类型 | 参数说明 |
|---|---|---|---|
| ret | M | String(100) | 包含返回码及描述信息的JSON字符串,格式为{"code":retcode, "msg": "description"},retcode为返回码,description为返回码描述信息。返回码请参见错误码。 |