目录

更新测试版本

功能介绍

此接口用于更新已创建的测试版本。

在架的测试版本不允许调用此接口。

  • 如果需要改其他参数，请新建一个测试版本。

接口原型

承载协议

HTTPS PUT

接口方向

服务商服务器 -> 华为服务器

接口URL

https://connect-api.cloud.huawei.com/api/publish/v2/test/app/version

数据格式

请求：Content-Type: application/json

响应：Content-Type: application/json

请求参数

[h2]Header

参数名称

必选(M)/可选(O)

类型

参数说明

client_id

M

String

API客户端ID。

创建第三方平台成功后系统自动分配的客户端ID，可在第三方管理平台“开发配置 > 开发资料设置”页面中获取，详情请参见接口访问凭证（平台访问凭据）。

Authorization

M

String

认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取平台级Token中获取的access_token。

[h2]Query

参数名称

必选(M)/可选(O)

类型

参数说明

appId

M

String

应用ID。

[h2]Body

请求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

VersionExtInfo

版本扩展信息。

openTestInfo

O

OpenTestInfo

开放式测试信息。

packagePermissionIntroVideoList

O

List<PackagePermissionIntroVideo>

软件包权限使用场景说明视频。

数组长度不超过100。

AppLanguage

参数名称

必选(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。

注意：

接口不校验素材的格式（尺寸、分辨率、文件后缀等），请开发者自行保证素材格式的准确性，以免影响素材最终的呈现效果。

DeviceMaterial

参数名称

必选(M)/可选(O)

类型

参数说明

deviceType

M

Integer

设备类型。

取值范围：

  • 4：手机
  • 5：平板

appIcon

O

String(300)

应用图标下载地址（不少于1个字符，否则应用信息不完整）。

注意：

作为输入参数是相对地址，作为查询结果是完整地址。

screenShots

O

List<String(300)>

应用截屏地址（不少于1个字符，否则应用信息不完整）。

多个地址以英文逗号隔开，最多不超过10个地址，最少不少于3个地址。

注意：

作为输入参数是相对地址，作为查询结果是完整地址。

showType

O

Integer

截图展现方式。

取值范围：

  • 0：竖屏
  • 1：横屏

promoGraphics

O

List<String(300)>

宣传图片地址。

多个地址以英文逗号隔开，最多不超过10个地址。

注意：

作为输入参数是相对地址，作为查询结果是完整地址。

DeviceTypeInfo

参数名称

必选(M)/可选(O)

类型

参数说明

deviceType

M

Integer

设备类型。

取值范围：

  • 4：手机
  • 5：平板

appAdapters

O

String

适配设备类型。

  • 5：平板
    说明：

    当deviceType为4（手机）时，系统会默认兼容分发到平板设备，即给appAdapters赋值5。

VersionExtInfo

参数名称

必选(M)/可选(O)

类型

参数说明

testUserName

O

String(128)

应用审核信息的测试账号。

注意：

邀请测试不支持修改。

testUserPassword

O

String(128)

应用审核信息的测试用户密码。

注意：

邀请测试不支持修改。

appRemark

O

String(300)

应用审核信息的备注。

注意：

邀请测试不支持修改。

isSignedCommitment

O

Integer(32)

是否签署合规承诺函 默认空为未签署 ，已签署为1，目前只有元服务服务签署。

注意：

邀请测试不支持修改。

registeredIdType

O

Integer(32)

备案证件类型。

  • -1：清空数据，同时也会清空registeredIdNumber的内容。
  • 1：面向企业，备案证件为社会信用
  • 2：面向个人，备案证件为身份证
  • 3：面向机构，备案证件为机构代码
注意：

邀请测试不支持修改。

registeredIdNumber

O

String(64)

备案证件号码。

  • registeredIdType为1时，对应社会信用代码
  • registeredIdType为2时，对应身份证号码
  • registeredIdType为3时，对应机构代码
注意：

邀请测试不支持修改。

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)

隐私权利网址。

OpenTestInfo

参数名称

必选(M)/可选(O)

类型

参数说明

startTime

M

Integer(64)

测试版本开始时间，UTC时间。

endTime

M

Integer(64)

测试版本结束时间，UTC时间。

testDesc

O

String(50)

测试版本描述。

testTaskInfo

O

TestTaskInfo

测试发布信息。

TestTaskInfo

参数名称

必选(M)/可选(O)

类型

参数说明

groupInfos

M

GroupInfo

测试用户信息。

注意：

公开测试不支持修改。

needShareLink

O

Integer

是否需要生成分享链接。

取值范围：

  • 0：不需要。
  • 1：需要。

publicTestInstallLimit

O

Integer

公开测试安装次数上限。当前默认是10万次。

注意：

邀请测试不支持修改。

displayArea

O

String(32)

展示区域。

取值范围：

  • 1：AppGallery客户端测试专区。
说明：
  • 邀请测试该字段必填。
  • 公开测试该字段选填。

GroupInfo

参数名称

必选(M)/可选(O)

类型

参数说明

groupId

O

String(32)

测试群组ID。

PackagePermissionIntroVideo

参数名称

必选(M)/可选(O)

类型

参数说明

lang

M

String(8)

语言种类，取值参见语言类型。

permissionName

M

String(512)

权限标记字符串。

deviceType

M

Integer(32)

设备类型。

取值范围：

  • 4：手机
  • 5：平板

objectId

M

String(512)

文件在OBS上的objectId。（先调用获取上传文件地址接口，然后调用上传文件接口上传文件，最后得到获取上传文件地址接口返回的objectId。）

请求示例

 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"]
        }
      ]
    }
  ],
  "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"
    }
  },
  "packagePermissionIntroVideoList": [
    {
      "lang": "zh-CN",
      "permissionName": "*****",
      "deviceType": 4,
      "objectId": "CN/2024052102/********.spk"
    }
  ]
}

响应参数

参数名称

必选(M)/可选(O)

类型

参数说明

ret

M

String(100)

包含返回码及描述信息的JSON字符串，格式为{"code":retcode, "msg": "description"}，retcode为返回码，description为返回码描述信息。返回码请参见错误码。

响应示例

{ 
     "ret": { 
         "code": 0, 
         "msg": "success" 
     }, 
}