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

更新说明

更新时间更新说明
2022-06-08请求参数新增customer_contact;请求参数删除player_customer_email、player_customer_phone、player_customer_qq、ascription_type、proxy_contract_url、authorize_type、authorize_url、authorize_desc、approval_doc_number、approval_doc_type、approval_doc_start_time、approval_doc_end_time、approval_doc_url、culture_record_number、culture_record_url、operation_license_url、absolve_declare_url;请求参数summary不能多于13个字

接口功能

此接口用于更新资源相关信息,不会新增版本。

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

接口原型

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

请求参数

参数名称参数类型是否必传适用资源类型(无说明则都适用)备注
pkg_namestring必传应用包名
version_codestring必传版本号
app_subnamestring非必须合作游戏副标题,1-10 个字符,不得包含空格等特殊字符
summarystring必传一句话简介,不多于 15 个字符,不能包含任何标点符号和空格
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
video_pic_urlstring非必传合作游戏游戏宣传视频横屏封面图,尺寸:1080*594px,图片格式:jpg/png,小于 1M
cover_urlCoverURLInfo必传合作游戏游戏空间封面图,请求时需转换成json格式,结构参考 CoverURLInfo
record_identification_codestring非必传合作游戏备案识别码,有版号时必填,10 位数字
record_identification_imagestring非必传合作游戏渠道绑定截图,有版号时必填,jpg/png 格式的图片,大小不超过 1M
other_cetificate_urlstring非必传合作游戏其他补充资质,支持 zip 格式,大小不超过 30M
business_usernamestring必传商务联系人姓名
business_emailemail必传商务联系人邮箱
business_mobilestring必传商务联系人电话
business_qqstring非必传合作游戏商务联系人 QQ
business_positionstring非必传合作游戏商务联系人职务
business_addressstring非必传合作游戏商务联系人办公地址
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:周末&节假日服务时间

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

oppo应用商店分阶段发布APP

oppo应用商店分阶段发布APP

能力介绍

在应用发布新版本时,你可以采用分阶段发布的方式对新版本进行分阶段更新,先向一定比例的用户发布更新的版本,快速获取用户对新版本的反馈意见,验证产品功能的稳定性,降低全量发布可能出现的风险及影响范围。

操作说明

使用分阶段发布能力

您的APP当前上架版本为全网发布时,可提交新版本并设置分阶段发布(即分阶段发布只适用于应用程序更新
)。

路径:OPPO开放平台→管理中心→应用服务平台→移动应用列表→版本升级

创建分阶段发布版本

在“版本升级”页上传包体并填写版本信息。

发布类型:选择“分阶段发布”;

生效时间:阶段一起始时间需选择当前时间的24小时后,整个分阶段发布周期(从阶段一的起始时间到最后一个阶段的结束时间)不超过30天。达到最后一个阶段的结束时间时,分阶段发布将自动转为全网发布,当前在架的正式版本将下架;

发布百分比:支持填写大于0且小于100的整数或小数,下一阶段的发布百分比必须大于上一阶段的发布百分比;

默认至少填写一个发布阶段,如需添加更多阶段,可点击“添加更多阶段”,上限为10个;

分阶段发布说明:可填写备注信息,仅供开发者自行参考。

完善其他信息后,点击“提交审核”,提交成功后,该版本的审核状态将更新为“审核中”。

管理分阶段发布版本

审核期间,在应用详情页可以对分阶段发布版本查看详情、催审、撤销审核。

审核通过后,软件商店将按设置的生效时间和发布百分比分发该版本,正式版本和分阶段发布版本将同时在架。开发者可以在应用详情页更新资料、查看和更新发布设置。

在“发布设置”页面,可查看分阶段版本的发布状态、发布设置、历史操作记录、发布说明等,并进行更新分阶段发布、暂停分阶段发布、恢复分阶段发布、取消分阶段发布操作。

更新分阶段发布

点击“更新分阶段发布”按钮,对于未到生效时间的发布阶段,支持修改生效时间、发布百分比。对于已到生效时间的阶段,不支持修改生效时间、发布百分比。支持修改分阶段发布说明。生效时间、发布百分比、发布说明的填写要求和创建分阶段发布时相同。

点击“确定”后,软件商店将按更新后发布设置去分发该版本

暂停分阶段发布

分阶段发布生效后,点击“暂停分阶段发布”按钮,在弹窗中点击“确定”,分阶段发布版本将在软件商店暂时下架。

恢复分阶段发布

分阶段发布暂停期间,点击“恢复分阶段发布”按钮,在弹窗中点击“确定”,该分阶段发布将在软件商店恢复上架,按照设置的生效时间和发布百分比继续分发。如当前时间已经晚于最后一个阶段的结束时间,不可恢复分阶段发布。

取消分阶段发布

分阶段发布未生效和已生效期间,点击“取消分阶段”按钮,在弹窗中点击“确定”,可以取消分阶段发布,取消后,该版本将在软件商店下架。

提交新版本

当APP的各版本都审核完成时,点击正式版本操作栏的“版本升级”按钮,“发布类型”选择全网发布或分阶段发布,可更新正式版本或分阶段发布版本。提交审核后,当前在架的分阶段发布版本将下架。

常见FAQ

1)该能力面向的开放对象是哪些?

普通应用、合作应用、合作游戏,且当前有对全网用户可见的在架版本。

2)设置的比例代表什么含义?

以设置10%为例,代表在软件商店内有10%的活跃用户可以看到你的新版本。

3)该包是否会影响到正常版本的分发?

使用该能力后,新包和旧包同时保持上架,新包仅分发给设置的比例所命中用户群。

4)如果使用分阶段发布的新包有问题,想上传新的包去覆盖怎么操作?

只要保证新包版本号大于上一次的包即可。