目录

更新测试版本

功能介绍

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

  • 针对设备类型为“智能表”目前为受限开放,若您想要体验使用,可以通过在线工单系统与我们联系,工单 “问题分类”请选择 “上架与运营-应用市场-应用测试”,并在“问题描述”中提供您的开发者名称,开发者ID、应用名称、APP ID。

接口调用者的角色:账号持有者、管理员、APP管理员、运营。

接口原型

承载协议

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

本接口支持使用Service Account方式和API客户端方式,区别请参见获取服务端授权。

Service Account方式:

参数名称

必选(M)/可选(O)

类型

参数说明

Authorization

M

String

认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。

API客户端方式:

参数名称

必选(M)/可选(O)

类型

参数说明

client_id

M

String

客户端ID,获取方法参考创建API客户端。

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”,则表示当AppGallery支持的国家或地区列表中新增某个国家或地区时,版本将自动分发到新增的国家和地区。国家码列表请参见国家码。

注意:

取值不能只包含OTHER。仅公开测试支持填写此字段。

extInfo

O

VersionExtInfo

版本扩展信息。

openTestInfo

O

OpenTestInfo

测试版本信息,包含测试版本开始时间和结束时间。

packagePermissionIntroVideoList

O

List<PackagePermissionIntroVideo>

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

数组长度不超过100。

versionVocReq

O

List<VersionVocReq>

应用版本已解决问题。

数组长度不超过1000。

仅公开测试支持填写此字段。

说明:

调用查询应用未处理的问题工单接口可以查询用户反馈的应用问题。如果在应用版本更新时某些问题已经解决,可以将这些问题提交审核,工单平台验证通过后会关闭工单。

请求示例

 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": {
    "privacyPolicy": "http://**********",
    "privacyRightsUrl": "http://*********"
  },
  "openTestInfo": {
    "startTime": 1716*****000,
    "endTime": 1717*****000,
    "testDesc": "版本描述demo",
    "testTaskInfo": {
      "groupInfos": [
        {
          "groupId": "761e*****************008",
          "groupName": "string",
          "addedTesterNum": 0,
          "bind": 0
        }
      ],
    "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

ConnectRet

包含返回码及描述信息的结果。

响应示例

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