修改资源包版本-资源包预下载-Connect API

功能介绍

若isDraft传参为0，提交资源包预下载任务。提交后，资源包任务为“预下载”状态。
若isDraft传参为1，修改资源包下载任务信息。修改后，资源包任务为“草稿”状态。

接口原型

承载协议	HTTPS PUT
接口方向	开发者服务器 ->华为服务器
接口URL	https://connect-api.cloud.huawei.com/api/games-background-assets-service/v1/open-gw/dev/{devId}/package-versions
数据格式	请求消息：Content-Type: application/json 响应消息：Content-Type: application/json

请求参数

Header

展开

参数名称	必选(M)/可选(O)	类型	参数说明
client_id	M	String	客户端ID，获取方法参考创建API客户端，其中“角色”支持勾选“APP管理员”、“管理员”、“运营”。
Authorization	M	String	认证信息，格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
requestId	M	String	请求ID，最大长度128个字符，必须唯一。开发者自定义，用于鉴别是否是重复请求。

Path

展开

参数名称	必选(M)/可选(O)	类型	参数说明
devId	M	Long	开发者ID。

Body

展开

参数名称	必选(M)/可选(O)	类型	参数说明
modifyPackageVersionReq	M	GWOpModifyPackageVersionReq	修改资源包版本请求体。

GWOpModifyPackageVersionReq

展开

参数名称	必选(M)/可选(O)	类型	参数说明
isDraft	M	Int(32)	是否草稿： 0：提交。提交之后进入预发布状态。 1：草稿。草稿状态支持重新编辑。
resourceVersion	O	GWOpPackageVersionEntity	修改的资源包版本信息。

参数名称

必选(M)/可选(O)

类型

参数说明

isDraft

Int(32)

是否草稿：

0：提交。提交之后进入预发布状态。
1：草稿。草稿状态支持重新编辑。

resourceVersion

GWOpPackageVersionEntity

修改的资源包版本信息。

GWOpPackageVersionEntity

展开

参数名称	必选(M)/可选(O)	类型	参数说明
versionId	M	Long	资源包版本ID。
packageName	O	String	游戏包名。最大长度255个字符。
appId	M	String	游戏APP ID，获取方法参考查询应用信息。
version	O	Int	版本号。
startTime	O	Long	开始下载时间。
endTime	O	Long	结束下载时间。

请求示例

收起
自动换行
深色代码主题
复制
PUT games-background-assets-service/v1/open/dev/1******7/package-versions HTTP/1.1
Host: connect-api.cloud.huawei.com
client_id: 41******68
Content-Type: application/json
Authorization: Bearer ******
{
   "isDraft": 0,
    "resourceVersion": {
      "versionId": 0,
      "packageName": "com.abc.test",
      "appId": "12345678",
      "version": 999999999,
      "startTime": 1752595200000,
      "endTime": 1752699999999,
    }
  }

响应参数

展开

参数名称	必选(M)/可选(O)	类型	参数说明
ret	M	GbasRet	包含返回码及描述信息的JSON字符串，格式为{"code":retcode, "msg": "description"}，retcode为返回码，description为返回码描述信息。

GbasRet
展开
参数名称

必选(M)/可选(O)

类型

参数说明

code

O

Int

返回码，请参见错误码。

msg

O

String

返回码描述信息。

参数名称	必选(M)/可选(O)	类型	参数说明
code	O	Int	返回码，请参见错误码。
msg	O	String	返回码描述信息。

响应示例

收起
自动换行
深色代码主题
复制
{
    "ret": {
      "code": 0,
      "msg": "string"
    }
}

调用示例

收起
自动换行
深色代码主题
复制
public static JSONObject modifyPkgVersion(String domain, String clientId, String token) {
        HttpPut put = new HttpPut(domain + "/api/games-background-assets-service/v1/open-gw/dev/11/package-versions");
        put.setHeader("Authorization", "Bearer " + token);
        put.setHeader("client_id", clientId);
        put.setHeader("requestId", "1");
        JSONObject resourceVersion = new JSONObject();
        resourceVersion.put("packageName", "com.abc.test");
        resourceVersion.put("appId", "12345678");
        resourceVersion.put("version", 999999999);
        resourceVersion.put("startTime", 1752595200000L);
        resourceVersion.put("endTime", 1752699999999L);
        JSONObject modifyRequest = new JSONObject();
        modifyRequest.put("isDraft", 1);
        modifyRequest.put("resourceVersion", resourceVersion);
        StringEntity entity = new StringEntity(modifyRequest.toString(), Charset.forName("UTF-8"));
        entity.setContentEncoding("UTF-8");
        entity.setContentType("application/json");
        put.setEntity(entity);
        try {
            CloseableHttpClient httpClient = HttpClients.createDefault();
            CloseableHttpResponse httpResponse = httpClient.execute(put);
            int statusCode = httpResponse.getStatusLine().getStatusCode();
            if (statusCode == HttpStatus.SC_OK) {
                BufferedReader br = new BufferedReader(
                    new InputStreamReader(httpResponse.getEntity().getContent(), Consts.UTF_8));
                String result = br.readLine();
                JSONObject object = JSON.parseObject(result);
                return object;
            }
        } catch (Exception e) {
            System.out.println(e);
        } finally {
            put.releaseConnection();
        }
        return null;
    }