为指定游戏创建新版本(更新游戏)。
使用 POST 方式发起请求。
下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表,参考 公共请求参数。
字段 | 位置 | 类型 | 必填 | 说明 | 值 |
---|---|---|---|---|---|
Action | Query | String | 是 | 公共参数,OpenAPI 接口名称 | CreateGameVersion |
Version | Query | String | 是 | 公共参数,OpenAPI 接口版本 | 2022-02-10 |
字段 | 类型 | 必填 | 说明 |
---|---|---|---|
game_id | String | 否 | 游戏 ID,可通过调用 ListGame 接口获取
|
custom_game_id | String | 否 | 用户自定义游戏 ID,可通过调用 ListGame 接口获取
|
download_url | String | 是 | 游戏包下载地址 |
package_name | String | 是 | 游戏包名,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败) |
version_code | Int64 | 是 | 游戏版本 ID,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败) |
md5 | String | 是 | 游戏文件 MD5,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败) |
package_size | Int64 | 是 | 文件大小,单位 byte,通过调用 DetailParseTask 接口返回(对应 file_size 字段),限制最大值为 2199023254528(即 2147483647KB) |
通用返回参数,参考 ResponseMetadata 结构说明。
Result 字段包含以下参数:
字段 | 类型 | 说明 |
---|---|---|
version_id | String | 创建成功的游戏版本 ID |
is_new | Boolean | 游戏版本是否新建成功:
|
POST https://open.volcengineapi.com?Action=CreateGameVersion &Version=2022-02-10 &<通过header传入的公共请求参数> { "game_id": "7064470096059xxxxxx", "download_url": "https://xxx-file.xxxxxx.com/cloudgame/xxxxxx.apk?x-expires=25862xxxxxx&x-signature=XXXXXX", "package_name": "com.image.gamename", "version_code": 236, "md5": "5403bf7211ec9fb042a6825876xxxxxx", "package_size": 78460345 }
{ "ResponseMetadata": { "Action": "CreateGameVersion", "Region": "cn-north-1", "RequestId": "2022021615311701022509900807277480", "Service": "veGame", "Version": "2022-02-10" }, "Result": { "version_id": "7064470096059833132", "is_new": true } }