You need to enable JavaScript to run this app.
导航
游戏版本创建
最近更新时间:2025.01.20 15:42:48首次发布时间:2022.03.01 17:31:35

为指定游戏创建新版本(更新游戏)。

请求方式

使用 POST 方式发起请求。

请求参数

下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表,参考 公共请求参数

字段
位置
类型
必填
说明
ActionQueryString公共参数,OpenAPI 接口名称CreateGameVersion
VersionQueryString公共参数,OpenAPI 接口版本2022-02-10

Body 参数

字段
类型
必填
说明

game_id

String

游戏 ID,可通过调用 ListGame 接口获取

当传入 custom_game_id 时,可不传入(以 game_id 优先)

custom_game_id

String

用户自定义游戏 ID,可通过调用 ListGame 接口获取

当传入 game_id 时,可不传入

download_urlString游戏包下载地址
package_nameString游戏包名,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败)
version_codeInt64游戏版本 ID,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败)
md5String游戏文件 MD5,通过调用 DetailParseTask 接口返回(需保证传入信息的准确性,否则启动游戏可能失败)
package_sizeInt64文件大小,单位 byte,通过调用 DetailParseTask 接口返回(对应 file_size 字段),限制最大值为 2199023254528(即 2147483647KB)

返回结果

通用返回参数,参考 ResponseMetadata 结构说明

Result 字段包含以下参数:

字段
类型
说明
version_idString创建成功的游戏版本 ID

is_new

Boolean

游戏版本是否新建成功:

  • true(新创建的游戏版本)
  • false(游戏版本已存在,可增加对应的文案提示)

示例

请求示例

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
    }
}