OPPO开放平台API传包能力接入 多包资料更新

多包资料更新

更新说明

更新时间更新说明
2022-06-08请求参数summary不能多于13个字符

接口功能

此接口用于多包应用资料更新。

接口处理可能会比较耗时,建议客户端执行等待时间设置为10秒以上。

接口原型

-请求路由:/resource/v1/app/multi-updm
-请求方法:POST
-请求类型:Content-Type: x-www-form-urlencoded

请求参数

参数名称参数类型是否必传备注
pkg_namestring必传包名
version_codestring必传版本号
summarystring必传一句话简介,不多于 13 个字符,不能包含任何标点符号和空格
detail_descstring必传软件介绍,不少于 20 个字
update_descstring必传版本说明,不少于 5 个字
privacy_source_urlstring必传隐私政策网址
icon_urlstring必传图标 url,尺寸:512*512px,图片格式:png,小于 1M
pic_urlstring必传竖版截图 url,多个用英文逗号分隔,不能少于两张,上传 3-5 张截图,支持 jpg、png 格式。 截图尺寸要求:1080*1920,单张图片不能超过 1M
landscape_pic_urlstring非必传横版截图 url,多个用英文逗号分隔,上传 3-5 张截图,支持 jpg、png 格式。 截图尺寸要求:1915*1080,单张图片不能超过 1M
video_urlstring非必传游戏宣传视频地址,小于 30MB,支持格式:MP4
video_url_materialVideoInfo[]非必传视频扩展信息,请求时需转换成json格式,格式参考VideoInfo
test_descstring必传测试附加说明,最多输入 400 个字符
electronic_cert_urlstring非必传电子版权证书,上传 PDF 格式文件,不能超过 20MB
copyright_urlstring必传软件版权证明
icp_urlstring非必传ICP 备案网址或备案号
special_urlstring非必传特殊类证书,支持 jpg、png 格式的图片,每张图片大小不超过 1M
special_file_urlstring非必传特殊类证书压缩包,支持 rar、zip 格式的文件,大小不能超过 30M
business_usernamestring必传商务联系人姓名
business_emailemail必传商务联系人邮箱
business_mobilestring必传商务联系人电话

VideoInfo

  • 可从文件上传接口中获取
字段类型说明
urlstring视频地址
md5string视频MD5值
sizeint视频文件大小
widthint视频尺寸:宽
heightint视频尺寸:高
fpsint视频帧率
durationint视频时长
definitionint视频码率

请求响应

响应说明

字段类型说明
errnoint错误码,为 0 表示请求正常
dataUpdBody响应体,结构参考 UpdBody

UpdBody

字段类型说明
successboolen请求成功时返回,必为 true
messagestring响应信息,请求失败时会返回错误信息说明
logidint请求ID

响应示例

成功示例

{
    "errno":0,
    "data":{
        "success":true,
        "message":""
    }
}

失败示例

{
    "errno":911219,
    "data":{
        "message":"游戏暂不支持 CPU 多包",
        "logid":4218474084
    }
}

OPPO开放平台API传包能力接入 发布版本

更新说明

更新时间更新说明
2022-06-08请求参数新增age_level、adaptive_equipment、adaptive_type、customer_contact;
请求参数删除player_customer_email、player_customer_phone、player_customer_qq;
请求参数summary不能多于13个字符

接口功能

此接口用于补充完善资源相关信息,会新增版本,为异步处理任务,可调用 获取任务状态 接口查询任务处理结果。

接口处理可能会比较耗时,建议客户端执行等待时间设置为10秒以上。

接口原型

-请求路由:/resource/v1/app/upd
-请求方法:POST
-请求类型:Content-Type: x-www-form-urlencoded

请求参数

参数名称参数类型是否必传适用资源类型(无说明则都适用)说明
pkg_namestring必传应用包名
version_codestring必传版本号
apk_urlApkInfo[]必传apk 包信息,请求时需转换成json格式,CPU 多包传多个,结构参考 ApkInfo
app_namestring必传应用名称
app_subnamestring非必传合作游戏副标题,1-10 个字符,不得包含空格等特殊字符
second_category_idint必传二级分类 ID,详情参照对照表
third_category_idint必传三级分类 ID,详情参照对照表
summarystring必传一句话简介,不多于 13 个字符,不能包含任何标点符号和空格
detail_descstring必传软件介绍,不少于 20 个字
update_descstring必传版本说明,不少于 5 个字
privacy_source_urlstring必传隐私政策网址
icon_urlstring必传图标 url,尺寸:512*512px,图片格式:png,小于 1M
pic_urlstring必传竖版截图 url,多个用英文逗号分隔,不能少于两张,上传 3-5 张截图,支持 jpg、png 格式。截图尺寸要求:1080*1920,单张图片不能超过 1M
landscape_pic_urlstring非必传横版截图 url,多个用英文逗号分隔,上传 3-5 张截图,支持 jpg、png 格式。截图尺寸要求:1915*1080,单张图片不能超过 1M
video_urlstring非必传游戏宣传视频地址,小于 30MB,支持格式:MP4
video_url_materialVideoInfo[]非必传视频扩展信息,请求时需转换成json格式,格式参考VideoInfo
online_typeint必传发布类型,1-审核立即发布;2-定时发布
sche_online_timedatetime非必传定时发布时间,online_type=2 时必填,不能早于当前时间
test_descstring必传测试附加说明,最多输入 400 个字符
electronic_cert_urlstring非必传电子版权证书,上传 PDF 格式文件,不能超过 20MB
copyright_urlstring必传应用、合作应用软件版权证明
icp_urlstring非必传应用、合作应用ICP 备案网址或备案号
special_urlstring非必传应用、合作应用特殊类证书,支持 jpg、png 格式的图片,每张图片大小不超过 1M
special_file_urlstring非必传应用、合作应用特殊类证书压缩包,支持 rar、zip 格式的文件,大小不能超过 30M
game_typeint必传合作游戏游戏类型,1-单机;2-网游;3-棋牌;5-超休闲
video_pic_urlstring非必传合作游戏游戏宣传视频横屏封面图,尺寸:1080*594px,图片格式:jpg/png,小于 1M
cover_urlCoverURLInfo必传合作游戏游戏空间封面图,请求时需转换成json格式,结构参考 CoverURLInfo
ascription_typeint必传合作游戏游戏归属权,1-自研;2-代理
proxy_contract_urlstring必传合作游戏授权合同或协议/代理授权合同或协议 ascription_type=2 时必填,jpg/png 格式的图片,不超过 1M
authorize_typeint必传合作游戏软件著作权登记类型,1-著作权证书
authorize_urlstring必传合作游戏软件著作权登记证,jpg/png 格式的图片,不超过 1M
authorize_descstring必传合作游戏软件著作权登记号
approval_doc_numberstring必传合作游戏游戏版号编号
approval_doc_typeint必传合作游戏版号有效期类型,1-永久有效;2-固定游戏期
approval_doc_start_timedatetime必传合作游戏版号有效期开始时间,approval_doc_type=2 时必填
approval_doc_end_timedatetime必传合作游戏版号有效期结束时间,approval_doc_type=2 时必填
approval_doc_urlstring必传合作游戏游戏版号证书,jpg/png 格式的图片,不超过 1M
record_identification_codestring非必传合作游戏备案识别码,有版号时必填,10 位数字
record_identification_imagestring非必传合作游戏渠道绑定截图,有版号时必填,jpg/png 格式的图片,大小不超过 1M
culture_record_numberstring非必传合作游戏文化部备案文件编号
culture_record_urlstring非必传合作游戏文化部备案文件,jpg/png 格式的图片,不超过 1M
operation_license_urlstring非必传合作游戏网络文化经营许可证,jpg/png 格式的图片,不超过 1M
absolve_declare_urlstring非必传合作游戏免责声明,jpg/png 格式的图片,不超过 1M
other_cetificate_urlstring非必传合作游戏其他补充资质,支持 zip 格式,大小不超过 30M
business_usernamestring必传商务联系人姓名
business_emailemail必传商务联系人邮箱
business_mobilestring必传商务联系人电话
business_qqstring非必传合作游戏商务联系人 QQ
business_positionstring非必传合作游戏商务联系人职务
business_addressstring非必传合作游戏商务联系人办公地址
age_levelint必传普通应用、合作应用、合作游戏APP年龄分级,示例:3
adaptive_equipmentint必传普通应用、合作应用、合作游戏平板适配,4-手机,5-平板,6-手机和平板
adaptive_typeint非必传普通应用、合作应用、合作游戏适配方式,1-平行视窗,2-横竖屏自适应适配
customer_contactstring,json字符串必传合作游戏客服联系方式,示例:
[{“contact_method”:“7”,“contact_info”:“点击客服头像Kate”,“working_hours”:“00:01-00:07”,“weekend_hours”:“00:23-01:14”}],
contact_method:

联系方式,1-客服电话,2-客服邮箱,3-客服QQ号,4-客服QQ公众号,5-客服微信号,6-客服微信公众号,7-游戏内联系客服路径

contact_info:客服联系信息
working_hours:工作服务时间
weekend_hours:周末&节假日服务时间

ApkInfo

字段类型说明
urlstringapk 包地址
md5stringapk 包 md5 值
cpu_codeint多包平台,64 位 CPU 包为 64,32 位 CPU 包为 32,非多包应用为 0

VideoInfo

-可从文件上传接口获取

字段类型说明
urlstring视频地址
md5string视频MD5值
sizeint视频文件大小
widthint视频尺寸:宽
heightint视频尺寸:高
fpsint视频帧率
durationint视频时长
definitionint视频码率

CoverURLInfo

字段类型说明
hmap横版封面,包含一个图片 url 字段,尺寸:939*507px,图片格式:JPG/PNG,小于 1M
vmap竖版封面,包含一个图片 url 字段,尺寸:756*1080px,图片格式:JPG/PNG,小于 1M

结构示例:

{
    "v":{
        "url":"http://******4494fa0b.jpg"
    },
    "h":{
        "url":"http://******80b90afc.jpg"
    }
}

请求响应

响应说明

字段类型说明
errnoint错误码,为 0 表示请求正常
dataUpdBody响应体,结构参考 UpdBody

UpdBody

字段类型说明
successboolen请求成功时返回,必为 true
messagestring响应信息,请求失败时会返回错误信息说明
logidint请求ID

响应示例

成功示例

{
    "errno":0,
    "data":{
        "success":true,
        "message":""
    }
}

失败示例

{
    "errno":800002,
    "data":{
        "message":"包名不能为空",
        "logid":3906849174
    }
}

APP上架华为商店应用升级需要满足哪些条件?

APP上架华为商店应用升级需要满足哪些条件?

应用升级需要满足哪些条件?

  • 升级版本的VersionCode等于或高于华为应用市场版本。
  • 升级版本的内置包名(非压缩包名称,该包名是程序代码的工程包名)同华为应用市场版本。
  • 升级版本APK包签名和华为应用市场上的版本保持一致。
  • 待升级应用,华为应用市场上是升级时前的版本。

了解更多升级应用的条件,请参见升级应用版本

华为开放平台升级应用版本 APP升级更新全流程教程

华为开放平台升级应用版本 APP升级更新全流程教程

应用上架后,如果您需要修改应用的分发国家、修改软件包、发布开放式测试版本等,需在AppGallery Connect中提交新版本给华为进行审核。审核通过后,用户将在华为应用市场搜索到最新的应用版本。

快速互动体验

操作流程

前提条件

您已准备好需要更新的材料或信息,例如新版本软件包、新应用素材等。

创建新版本

在AGC提交版本升级申请前,请先创建新版本。

  1. 登录 AppGallery Connect 网站,选择“我的应用”。
  2. 在应用列表中点击待升级的应用“状态”链接,系统进入该版本的“版本信息”页面。
  3. 点击右上角“升级”,左侧导航栏新增“新版本 – 准备提交”页面。

更新应用信息

如需修改应用信息,点击左侧导航栏“应用信息”进行编辑,详见配置应用基本信息。完成后点击“下一步”,进入“新版本 – 准备提交”页面。

上传新版本软件包

在“新版本 – 准备提交”页面的“软件版本”栏点击“软件包管理”,在弹出的软件包选取窗口点击“上传”,上传本地软件包。

软件包类型升级要求
APK不支持versionCode相同但软件包不同的升级。如您无需更换软件包,请直接选择当前上架版本的软件包。如您需要更换软件包,请确保您上传的软件包versionCode高于当前在架版本的versionCode,否则将上传失败。对于手机APK应用,新版本软件包签名必须与当前在架版本的软件包签名保持一致。如果您上传的APK包签名和当前在架版本的APK包签名不一致,请参见软件包签名不一致处理
RPK/APP/EXE请确保您上传的软件包versionCode不低于当前在架版本的versionCode。
AAB不支持versionCode相同但软件包不同的升级。如您无需更换软件包,请直接选择当前上架版本的软件包。如您需要更换软件包,请确保您上传的软件包versionCode高于当前在架版本的versionCode,否则将上传失败。

选择发布类型

如当前上架版本为全网发布,本次升级您可选择全网发布或分阶段发布。

  • 如您选择全网发布,设置“发布类型”为“全网发布”。
  • 如您选择分阶段发布,设置“发布类型”为“分阶段发布”,然后填写相关参数,具体参见分阶段发布应用

设置是否强制更新

对于发布到手机设备的APK应用,您还可开启强制更新功能。开启后,用户必须升级才能进入应用。

注意

更新其他版本信息

如需更新其他版本信息,请参考发布应用下对应应用类型的发布指导。

注意

在架应用不支持更改付费情况。如您想更改应用的付费情况,需下架并删除已上架应用,在重新发布应用时设置付费情况。

提交审核

所有信息确认无误后,点击右上角“提交审核”。

  • 如系统弹出如下提示,确认软件包版本号无误后,点击“确认”。
  • 如系统弹出如下提示,表示您上传的软件包versionCode与当前在架版本的versionCode相同。
    • 如您确认不更改versionCode,点击“确认”即可。但需注意,如果新版本软件包的versionCode和当前在架版本的versionCode相同,新版本上架后,华为应用市场客户端显示的版本更新日期保持不变,依旧为在架版本的发布日期。
    • 如果发现versionCode错误,点击“取消”,重新上传正确的软件包。

提交成功后,应用状态更新为“正在审核”。审核通过后,应用升级成功。

软件包签名不一致处理(仅适用于手机APK应用)

对于手机APK应用,当您在“软件包管理”窗口点击“选取”选择上传的软件包时,系统会即时校验签名一致性。如果您更新的软件包签名和当前在架版本的软件包签名不一致,您可参考以下情况采取相应措施:

说明

通过分阶段发布的应用在转为全网发布前,系统校验应用签名时以全网在架应用版本签名为准。

  • 若您发布的应用为游戏应用,在弹出的提示框中点击“确定”后,返回“软件包管理”窗口。此时,您需要重新上传与在架版本签名一致的应用版本。若您的游戏应用分发地为中国大陆以外地区,如您确实需要更换应用签名,请参考弹框提示与华为运营人员联系。
  • 若您发布的应用为普通应用,会弹出下方的提示框。您需要根据实际情况,做出相应选择。
    • 如您打包时使用了错误的签名,或上传了错误的应用版本时,选择第一个选项,点击“确认”即可删除该应用包并返回“软件包管理”窗口。此时,您必须重新上传与在架版本签名一致的应用版本。
    • 如您需要更换应用签名,选择第二个选项。此时,请根据提示框内容填写签名不一致原因并勾选免责声明,提示框内的所有项均为必填项。填写完成后,点击“提交”。

华为应用商店APP更新教程

华为应用商店APP更新教程

若您想提升应用的下载转化率和市场曝光度,建议您时常更新在架应用详情。您无需更换软件包即可方便快捷地上传一套效果较好的新素材应用于全网。

前提条件

  • 必须存在一个在架版本的应用。
  • 根据不同的更新方式,您需要提前准备对应的素材内容。
更新方式更新方式说明您需准备的素材内容
更新应用基本信息您无需更换软件包,通过升级同版本的方式即可更新应用的基本信息。升级审核通过后,应用详情更新成功。兼容设备。可本地化基础信息:语言、应用名称、应用介绍、应用一句话简介、新版本特性、应用图标、应用截图和视频。应用分类。开发者服务信息:官网。
仅更新应用素材通过素材更新实验,您可在不升级版本的情况下更新全网在架版本的应用素材。审核通过后,新素材立即生效上架,或手动发布上架。说明您需提前向华为运营人员发送申请邮件,申请使用素材管理功能,详情请参见申请使用服务。仅APK、RPK软件包类型支持仅更新应用素材。素材更新实验仅支持如下素材内容的更新:应用介绍应用一句话简介应用图标应用介绍截图应用介绍视频

更新应用基本信息

已全网上架的应用支持以同版本更新的方式升级。采用此升级方式,您可以仅修改应用详情,无需更新软件包。

说明

若在架应用的扩展文件发生变化时,不支持同版本更新,您必须上传新的APK软件包。

  1. 登录 AppGallery Connect 网站,点击“我的应用”。
  2. 在应用列表中选择待更新的应用,进入应用详情页。
  3. 在“版本信息”页面的右上角点击“升级”,左侧导航栏新增“新版本 – 准备提交”页面。
  4. 点击左侧导航栏“应用信息”,更新应用详情,详见配置应用基本信息。完成后点击“下一步”,系统进入“准备提交”页面。
  5. 在右侧“软件版本”下点击“软件包管理”,直接选择当前在架软件包,点击“选取”。说明当同时满足以下条件时,AGC支持您以同版本更新的方式升级扩展文件:
    • 新版本的APK的versionCode=在架版本的versionCode;
    • 新版本的APK的shaCode=在架版本的shaCode;
    • 新版本的APK的OBB扩展文件的sha256=在架版本的OBB扩展文件的sha256(主、补丁OBB分别一致)。
  6. 点击右上角“提交审核”,系统提示当前版本提交软件包versionCode与在架版本versionCode相同,点击“确认”。

提交成功后,应用状态更新为“正在审核”,版本号不变。审核通过后,应用详情更新成功,用户在华为应用市场将看到最新的应用详情信息。

仅更新应用素材

已上架应用通过创建素材更新实验可以更新应用素材,详情请参见素材更新

APP上架小米应用商店之后更新应用更新APP操作流程介绍

APP上架小米应用商店之后更新应用更新APP操作流程介绍:

已发布的应用,如需更新新版本,请参照以下流程。

小米应用商店支持应用同版本更新,根据小米应用商店系统逻辑要求,将apk_hash改变后,即可进行同版本更新。

1、进入应用管理界面,点击“管理”按钮进入应用详情页。

2、点击应用详情页“更新版本”按钮,即可进入完善资料-测试审核-发布上线的流程。

3、上传完成应用安装包,如应用包括拓展包与安装包,请一并上传。

项目说明备注
32位或32/64位兼容包
小米应用商店同时支持上传32位或32/64位安装包,请将相关安装包上传到此位置
具体相关内容请参考应用64位安装包上传操作指南
64位安装包
若您的应用同时拥有32位和64位安装包,请将64位安装包上传到此位置
主扩展包基本包的补充扩展软件
副扩展包若您需要上传两个扩展包,请将第二个扩展包上传至副扩展包处

4、若您的应用被检测到需要获取用户的敏感权限,请您按照相关权限项目进行说明,以便用户理解您获得权限的目的。

项目说明备注
获取定位您的应用将会获取用户定位,请您说明获取定位的目的
拨打电话您的应用将会利用用户设备拨打电话,请您说明拨打电话的目的
读取联系人您的应用将会获取用户联系人信息,请您说明读取联系人的目的
获取手机信息您的应用将会获取用户手机信息,请您说明获取手机信息的目的
录音您的应用将会获取为用户录音,请您说明获取录音的目的

5、完善应用的发布设置,根据需要选择应用的兼容设备、分类、发布地区与上线时间方式。

项目说明备注
兼容设备您的应用可下载与使用的设备类型
一级分类包含VR、实用工具、影音视听、聊天社交、图书阅读、学习教育、效率办公、时尚购物、居家生活、旅行交通、摄影摄像、医疗健康、体育运动、新闻咨询、娱乐消遣、金融理财等分类选择符合应用主要功能的分类项目,如应用符合多个分类,则可以自由选择,但不能选择无关的分类
二级分类根据一级分类对您的应用进行再次细分
分发地区应用可以下载并适用的地区如勾选其他海外地区,审核通过后,应用将会根据选择发布到对应海外地区
上线时间方式应用通过审核后上线时间方式选择
如对上线时间无特殊要求,可选择“审核通过后立即上线”。如选择定时发布,则无法取消或更改时间

6、填写应用本地化语言信息,星号标注为必填项,填写完毕请阅读小米应用商店应用品牌展示图注意事项并勾选“我已阅读并同意”。

项目说明备注
应用名称上传应用的官方全称具体审核规范请参考应用审核规范
应用图标展示在用户桌面的应用图标,需与apk包内图标一致具体审核规范请参考应用审核规范
版本名应用版本的标识号开发者每次更新应用时,版本名要大于上一次版本名,否则无法提交应用审核
开发者名称展示给用户的开发者名称应用信息内填写的开发者名称与提交应用审核使用的账号主体内开发者信息需保持一致
关键字用户通过关键字搜索到应用可以提供多个关键字,以空格隔开
一句话简介以一句话简单介绍应用勿使用极限词和虚假承诺等违反新广告法的内容;勿使用疑问、反问等句式;保持在17个汉字或34个字符之内,句末勿加标点。
应用介绍对应用功能、亮点的准确介绍,吸引用户如实介绍应用功能和亮点,方便用户快速上手,勿呈现过多的SEO优化和空行
隐私政策为了保护用户隐私而制定的政策措施,内容须包括该APP收集使用个人信息的目的、方式和范围具体政策参考应用添加隐私政策声明的重要通知
官网链接非必填。您公司官方网站的地址
测试账号非必填。若您的应用需要注册账号才能使用,请提供可以用于测试的账号与密码该账号将用于应用审核流程,将不会展示给用户
项目说明备注
应用截图应用内相关场景截图
手机截图使用手机操作应用时呈现的截图应用图片信息如需使用到手机外观图片,禁止使用 iPhone 或其他品牌手机外观素材,应用图片信息中系统状态栏禁止存在与本应用无关的第三方应用图标
应用视频介绍非必填。以视频的形式介绍您的应用应用视频在驳回状态是无法删除的,请在重新提交审核后发送应用视频删除申请至问题工单系统
应用品牌展示图非必填。是小米应用商店为开发者提供的一项对应用品牌的直观展示服务该项已不展示给用户

7、完善行业资质证明。

注:在行业资质证明模块提交的材料无法删除,若您未上传原有材料而仅提交新材料,原有材料将会被新上传材料替换。

项目说明备注
ICP 备案号国家对经营性互联网信息服务实行许可制度;对非经营性互联网信息服务实行备案制度。未取得许可或者未履行备案手续的,不得从事互联网信息服务开发者需要提供ICP备案截图,或ICP证和ICP备案号以证明资质
版权证明APP电子版权认证证书为您的app电子版的著作权证明,纸质软件著作权证书为您的app知识产权证明文件
免责承诺函对于承诺书的中提到的内容免除责任的一种形式
相关承诺函模板请参考常见保证(承诺)函模板,若应用不符合单本图书/书城类、理财类、医疗类三种中的一种,建议开发者提供书城类承诺函
特殊资质代理证书金融理财类、影音视听类、图书阅读类、新闻资讯类、实用工具类、聊天社交类、医疗健康类应用需提交ICP证或ICP备案截图等资质或代理授权书具体要求请参考特殊行业资质要求
应用安全评估报告针对具有舆论属性或社会动员能力的互联网信息服务的主体进行评估后产出的报告
非必填项,按需填写

​8、完善联系人信息并提交审核。

注:若未出现【联系人信息】模块或在【联系人信息】板块如果未展示输入验证码,请在【本地化语言信息】板块将本地化语言切换为简体中文。

9、提交审核后应用状态更新为等待审核,我们会在1-3个工作日内为您审核。

应用信息修改

针对已上线的版本,我们支持进行应用资料信息修改,请参照以下流程。

1、进入应用详情页,点击“查看资料”按钮。

2、点击“编辑资料”按钮,即可进入完善资料页面,后续流程与更新应用的3-9流程一致。

注:

  • 应用在驳回状态下不支持点击“编辑资料”按钮进行修改,如需修改,需点击“更新版本”按钮,才可在重新提交应用审核的时候进行修改。
  • 修改应用信息不支持修改应用名称,如需修改应用名称,可在提交审核或者版本更新状态下修改。