月度归档：2022年11月

OPPO开放平台应用标签解释说明

发表于由

OPPO开放平台应用标签解释说明

应用标签解释说明

为了使用户能放心使用商店，我们对商店的APP进行了分类，针对不同的审核结果进行了4个类别（A，B，C，D）的区分，不同类别都有对应的不同的内容展示规则，如果您对APP在商店的展示有疑问，根据您APP的具体分类参照以下规则进行解答，具体如下：

标签A

标签质量说明： 该类APP无质量问题

软件商店展示说明： 可以有资格通过系统算法被推荐至分类、榜单等推荐位，进行固定列表的各种商业化推广（如OPPO软件商店首页CPD投放）， 具体推广内容可联系营销平台代理商。

标签B

标签质量说明： 人工正在审核中或审核过程中发现有个别小问题或者内容类目属于平台不推荐的范围，您可以点击APP图标–版本管理，了解应用标签为”B“的详细原因，然后根据对应的修改建议进行修改，重新提交审核以便获取新的等级标签。

软件商店展示说明： 该类APP只能通过搜索进行下载，不会出现于其他推荐列表或专题中，也不能进行固定列表（如OPPO软件商店首页CPD投放）的商业化推广。

标签C

标签质量说明： Apk中包含体验不良的广告插件（如积分墙等）、与平台运营策略相冲突的APP，或人工审核发现有个别问题，您可以点击APP图标–版本管理，了解应用标签为”C“的详细原因，然后根据对应的修改建议进行修改，重新提交审核以便获取新的等级标签。

软件商店展示说明： 已安装过该类APP的用户可以接收到版本更新的通知，在OPPO软件商店可以精准搜索出来，不可商业化推广。

标签D

标签质量说明： 含有病毒、人工审核发现无法正常安装或存在无法正常使用的严重BUG、部分与平台运营策略相冲突的APP，您可以点击APP图标–版本管理，了解应用标签为”D“的详细原因，然后根据对应的修改建议进行修改，重新提交审核以便获取新的等级标签。

软件商店展示说明： 该类APP为下架状态，用户无法更新或者下载，不可进行商业化推广。

OPPO开放平台更新教程 应用更新资料流程

发表于由

OPPO开放平台更新教程 应用更新资料流程

应用更新资料流程

1）登录开发者帐号，在管理中心应用管理页面，点击“移动应用列表”—点击“更新资料”；

2）进入应用更新资料页面，修改资料一句话简介、软件介绍、版本说明、隐私权限说明，或者更改ICON、截图及版权证明。

3）修改完成后，点击提交审核，更新资料就提交完成了；

我们通常会在1-3个工作日内完成应用的更新资料审核。如超过3个工作日还未有审核结果，可点击页面右侧的在线客服进行催审。

OPPO应用市场同版本更新APP流程

发表于由

OPPO应用市场同版本更新APP流程

同版本更新流程

声明：

平台对同版本更新一直都是持反对态度，因为已下载过问题版本的用户不会收到同版本更新的通知，他们的问题将一直存在，直到您发布更高的版本。

但由于考虑到开发者的需求，平台允许每个版本享有一次同版本更新的机会，与此同时对于同版本更新的审核也会更严格，所以请各位谨慎使用同版本更新的机会，若您提交的同版本更新审核未通过，则只能通过增大版本号的方式重新上传应用。

1）登录开发者帐号，在管理中心应用管理页面，点击“移动应用列表”

2）点击应用名称进入展示页面，打开“同版本更新”功能

3）填写更新原因，点击“保存并继续按钮”

4）进入应用更新页面，点击“上传”，上传需更新的安装包，并填写相关软件信息后，点击继续

5）确认ICON、详情图、APP资质信息无误后，点击“提交审核”即可；

6）成功提交审核后,OPPO软件商店测试人员将在1-3个工作日进行审核,如超过3个工作日还未有审核结果,可点击页面右侧的在线客服进行催审。

OPPO开放平台应用认领流程

发表于由

应用认领流程

何为应用认领

如果您发现您的应用已经在OPPO软件商店上架或在上传应用时提示应用已存在，但您或您的团队从未在OPPO开放平台上传该应用，那么您可以通过认领的方式来领取应用的管理维护权。认领成功后，该应用会自动转入您的帐号下。

应用认领价值

认领对于app的整体量不会有影响，重新上传不会影响之前的下载量及评论量。但是如果您不认领，就无法统计出不同渠道的转化率和渠道质量。

不认领一方面不能对已有渠道进行很好的监测，另一方面无法享受到平台的福利活动，比如至美应用、活动推荐等。OPPO开放平台一直把开发者的利益放在首位，后续我们会不断加大对开发者的扶持力度，真诚希望您能成为我们的一员，携手共同前行。

应用认领流程

进入OPPO开放平台官网-管理中心-应用服务平台，点击移动应用认领（合作的游戏不允许认领）；

输入应用包名

输入想要认领的APP的包名(包名请与贵公司技术人员确认），前后不能有空格， 然后点击搜索；

该情况为其他开发者帐号创建未发布状态，不可认领，具体可咨询客服包名归属的帐号；如无法确认，建议更换包名创建发布。

下载签名空包

按照下图指引下载签名空包，请开发把空包打上和认领APP一样的签名；请仔细阅读签名文件获取方法，保持签名空包一致，审核通过率越高；签名文件获取方法：（开发人员阅读资料）

上传版本证明

此处上传APP的版权证明，建议提交《计算机软件著作权登记证书》、著作权人授权书等。证书越齐全审核通过率越高。著作权人授权书获取方法(开发人员阅读资料)

审核

提交审核后，就会看到认领记录中的状态，您可以随时查看到审核的结果和不通过的原因。应用认领的处理周期是1-2个工作日，如遇特殊情况，您可以联系在线客服帮您加急处理。

应用签名变更申请流程

发表于由

应用签名变更申请流程

如果您的应用需要进行签名变更，请按下述流程申请：将需要修改签名的应用相关信息（如下表格）发送至邮箱：devsig@oppo.com，我们将在1-3个工作日内处理，处理完毕后将邮件回复，请收到回复后在管理中心重新提交应用。

应用信息请务必完整提供。

邮件标题：应用签名变更申请+应用名称
正文：应用签名变更的原因。（修改签名的原因为必填项，无原因不予处理）
应用名称：
包名：com.*.
版本号：
APP官网地址：（贵司APP下载官网）——有的必须提供
附件：开发者注册证明（营业执照和身份证正反面，此身份证应与开发者注册时上传到后台的一致）
应用的最新APK安装包（如果安装包较大，请自行上传到网盘后，提供下载链接）
应用的软件著作权，若无软著，可以提供其他3个以上应用市场管理后台上架状态截图（整屏:附带右下角系统时间）。

OPPO开放平台API传包能力接入 查询多包应用详情

发表于由

查询多包应用详情

更新说明

更新时间更新说明
2022-06-08请求响应新增age_level、adaptive_equipment、adaptive_type、customer_contact

接口功能

此接口用于查询多包应用详情信息。

接口原型

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

请求参数

参数类型必传说明
pkg_namestring必传应用包名

请求响应

响应说明

参数类型说明
errnoint错误码，为0表示成功
dataMultiDetailInfo多包应用详情，结构参考MultiDetailInfo

MultiDetailInfo

字段类型说明
app_idstring应用ID
pkg_namestring应用包名
typeint应用类型
signstring应用包签名
dev_idstring开发者ID
app_keystring游戏支付key(公钥)
update_timestring应用更新时间
app_create_timestring应用创建时间
app_namestring应用名称
is_freezestring是否冻结，0-否；1-是
freeze_reasonstring[]冻结原因
refuse_reasonstring打回原因
tag_liststring游戏标签
is_businessstring是否合作，0-否；1-是
game_typestring游戏类型
second_category_idstring二级分类
third_category_idstring三级分类
copyright_urlstring软件版权证明
special_urlstring特殊类证书
special_file_urlstring特殊类证书压缩包
freeze_filestring冻结附件
business_usernamestring商务联系人姓名
business_emailstring商务联系人邮箱
business_mobilestring商务联系人电话
business_qqstring商务联系人QQ
business_positionstring商务联系人职务
business_addressstring商务联系人办公地址
freeze_advicestring冻结建议
app_typestringapp类型，0-未设置；1-合作应用
app_real_typestringapp类型，0-非合作状态，1-合作状态
electronic_cert_urlstring电子版权证书
icp_urlstringICP备案网址或备案号
apk_infomap<String, ApkVersionInfo>应用多包信息，key为版本号，值字段参考ApkVersionInfo
pkg_symbolint包类型，1-cpu多包；2-多签名多包
second_category_namestring二级分类名称
third_category_namestring三级分类名称
transfer_stateint转让状态，-1-无；1-审核通过；2-审核不通过；3-同意接受；4-不同意接受
last_version_namestring最新版本名称
same_version_statusint同版本更新申请状态，0-未使用；1-已使用
age_levelstringAPP年龄分级，示例：3
adaptive_equipmentstring平板适配，4-手机，5-平板，6-手机和平板
adaptive_typestring适配方式，1-平行视窗，2-横竖屏自适应适配

ApkVersionInfo

字段类型说明
version_idstring版本ID
app_idstring应用ID
version_codestring版本号
version_namestring版本名称
apk_urlstringapk链接
apk_sizestringapk包大小
apk_md5stringapk包MD5
header_md5stringapk头部MD5
package_permissionstring[]包权限
package_permission_descstring包权限描述
resolutionstring分辨率
version_typestring版本类型，1-新增；2-更新；3-更新资料
create_timestring版本创建时间
cpu_codestringcpu类型
apk_full_urlstringapk包完整链接
sign_descstring多签名类型描述
signstring包签名
online_typestring发布类型1-审核立即发布2-定时发布
sche_online_timestring定时发布时间
test_typestring测试类型
test_start_timestring游戏内测开始时间
test_end_timestring游戏内测结束时间
player_customer_emailstring玩家客服游戏
player_customer_phonestring玩家客服电话
player_customer_qqstring玩家客服QQ
is_signaturestring是否签名，0-否；1-是
is_pre_downloadstring是否开启预下载，1-否；2-是
app_namestring应用名称
icon_urlstring图标url
icon_md5string图标md5
summarystring一句话简介
detail_descstring软件介绍
update_descstring版本说明
app_subnamestring副标题
test_descstring测试附加说明
video_urlstring视频地址
pic_urlstring竖屏截图地址
video_pic_urlstring游戏宣传视频横屏封面图
cover_urlstring游戏空间封面图
landscape_pic_urlstring横屏截图地址
privacy_source_urlstring隐私政策网址
levelstring等级，-1-D；0-C；1-B；2-A
statestring上架状态，1-上架；2-下架
online_timestring上架时间
offline_timestring下架时间
business_refuse_reasonstring商务审核打回理由
update_timestring更新时间
audit_status_namestring审核状态
offline_infostring下架信息
update_info_checknumber更新资料审核状态，1-审核中；0-不在审核中
level_tagstring等级标签
refuse_advicestring打回建议
refuse_reasonstring打回理由
refuse_filestring打回附件
pic_url_materialPicMaterialinfo[]竖版截图扩展信息，详情参考PicMaterialinfo

PicMaterialinfo

字段类型说明
urlstring图片地址
widthstring图片宽
heightstring图片高
md5string图片md5
sizestring图片大小

响应示例

成功示例

{
    "errno": 0,
    "data": {
        "app_id": "111",
        "pkg_name": "com.foo.bar.nearme.gamecenter",
        "type": 10,
        "sign": "23f1****e6cd",
        "dev_id": "11111",
        "app_secret": "909c****36a3",
        "server_secret": "132c****b858",
        "app_key": "5125****2ea5",
        "update_time": "2021-06-10 18:33:08",
        "app_create_time": "2021-06-10 17:38:52",
        "app_name": "xxxxx",
        "is_freeze": "0",
        "freeze_reason": [
            [
                null,
                null
            ]
        ],
        "refuse_reason": "",
        "tag_list": null,
        "is_business": "0",
        "game_type": "0",
        "second_category_id": "77",
        "third_category_id": "6689",
        "copyright_url": "http://******9fda50.jpg,,",
        "special_url": "",
        "special_file_url": "",
        "freeze_file": null,
        "business_username": "商务联系人姓名",
        "business_email": "44****@qq.com",
        "business_mobile": "13*******41",
        "business_qq": "",
        "business_position": "",
        "business_address": "",
        "freeze_advice": null,
        "app_type": "1",
        "app_real_type": "1",
        "ad_type": "0",
        "dev_name": "",
        "electronic_cert_url": "",
        "icp_url": "xxxxx",
        "refuse_advice": "",
        "state": "11",
        "apk_info": {
            "11111111": {
                "version_id": "11111111",
                "app_id": "111",
                "version_code": "1",
                "version_name": "1.0",
                "apk_url": "/******cbad.apk",
                "apk_size": "1.89 MB",
                "apk_md5": "f565****811e",
                "header_md5": "01b0****b816",
                "channel": "0",
                "package_permission": [
                    "android.permission.ACCESS_COARSE_LOCATION",
                    "android.permission.READ_CALENDAR",
                    "android.permission.READ_CALL_LOGS",
                    "android.permission.WRITE_CONTACTS",
                    "android.permission.WRITE_CAMERA",
                    "android.permission.CALL_PHONE"
                ],
                "package_permission_desc": null,
                "resolution": null,
                "version_type": "1",
                "create_time": "2021-06-10 18:33:08",
                "min_sdk_version": "16",
                "target_sdk_version": "29",
                "cpu_code": "32",
                "release_type": "1",
                "apk_full_url": "http://******16cbad.apk",
                "sign_desc": "A",
                "sign": "366d****f571,366d****f571",
                "online_type": "1",
                "sche_online_time": null,
                "test_type": "0",
                "test_start_time": "0000-00-00 00:00:00",
                "test_end_time": "0000-00-00 00:00:00",
                "player_customer_email": null,
                "player_customer_phone": null,
                "player_customer_qq": "",
                "is_signature": "0",
                "is_pre_download": "1",
                "app_name": "ceshi0007",
                "lang": "zh",
                "icon_url": "http://******7b633.jpg",
                "icon_md5": "",
                "summary": "xxxxxxxxxx",
                "detail_desc": "xxxxxxxxxx",
                "update_desc": "xxxxxxxxxx",
                "app_subname": "",
                "test_desc": null,
                "video_url": "",
                "pic_url": "http://******7983c2.jpg,http://******a6234f.jpg,http://******bdabfe.jpg",
                "video_pic_url": null,
                "cover_url": null,
                "landscape_pic_url": "",
                "privacy_source_url": "http://foo.bar.com",
                "release_desc": "",
                "region": "CN",
                "level": "1",
                "state": "1",
                "audit_status": "111",
                "online_time": "2021-06-11 11:40:40",
                "offline_time": "2021-06-11 09:07:10",
                "is_first_publish": "0",
                "business_refuse_reason": "a:1:{i:0;s:1:\"1\";}",
                "release_status": "0",
                "update_time": "2021年06月10日 18:33:08",
                "audit_status_name": "上线",
                "offline_info": null,
                "update_info_check": 0,
                "level_tag": "B",
                "refuse_advice": "",
                "refuse_reason": "1",
                "refuse_file": "",
                "permission_list": [
                    [
                        "android.permission.ACCESS_COARSE_LOCATION",
                        "获取WIFI定位",
                        ""
                    ],
                    [
                        "android.permission.READ_CALENDAR",
                        "读取日历",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CONTACTS",
                        "修改删除联系人",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CAMERA",
                        "使用摄像头",
                        ""
                    ],
                    [
                        "android.permission.CALL_PHONE",
                        "拨打电话",
                        ""
                    ]
                ],
                "pic_url_material": [
                    {
                        "url": "http://******7983c2.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******a6234f.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******bdabfe.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    }
                ]
            },
            "11111112": {
                "version_id": "11111112",
                "app_id": "12024352",
                "version_code": "1",
                "version_name": "1.0",
                "apk_url": "/apk/****6d80.apk",
                "apk_size": "1.9 MB",
                "apk_md5": "564a****6ad4",
                "header_md5": "01b0****b816",
                "channel": "0",
                "package_permission": [
                    "android.permission.ACCESS_COARSE_LOCATION",
                    "android.permission.READ_CALENDAR",
                    "android.permission.READ_CALL_LOGS",
                    "android.permission.WRITE_CONTACTS",
                    "android.permission.WRITE_CAMERA",
                    "android.permission.CALL_PHONE"
                ],
                "package_permission_desc": null,
                "resolution": null,
                "version_type": "1",
                "create_time": "2021-06-10 18:33:08",
                "min_sdk_version": "16",
                "target_sdk_version": "29",
                "cpu_code": "64",
                "sign_v1": "366d****f571",
                "sign_v2": "366d****f571",
                "sign_v3": "",
                "release_type": "1",
                "apk_full_url": "http://******/apk/202106/10/****6d80.apk",
                "sign_desc": "A",
                "sign": "366d****f571,366dc****f571",
                "online_type": "1",
                "sche_online_time": null,
                "test_type": "0",
                "test_start_time": "0000-00-00 00:00:00",
                "test_end_time": "0000-00-00 00:00:00",
                "player_customer_email": null,
                "player_customer_phone": null,
                "player_customer_qq": "",
                "is_signature": "0",
                "is_pre_download": "1",
                "app_name": "ceshi0007",
                "lang": "zh",
                "icon_url": "http://******37b633.jpg",
                "icon_md5": "",
                "summary": "xxxxxxxxxx",
                "detail_desc": "xxxxxxxxxx",
                "update_desc": "xxxxxxxxxx",
                "app_subname": "",
                "test_desc": null,
                "video_url": "",
                "pic_url": "http://******7983c2.jpg,http://******a6234f.jpg,http://******bdabfe.jpg",
                "video_pic_url": null,
                "cover_url": null,
                "landscape_pic_url": "",
                "privacy_source_url": "http://foo.bar.com",
                "release_desc": "",
                "region": "CN",
                "level": "1",
                "state": "2",
                "audit_status": "222",
                "online_time": "2021-06-11 09:06:28",
                "offline_time": "2021-06-11 11:36:31",
                "is_first_publish": "0",
                "business_refuse_reason": "a:1:{i:0;s:1:\"1\";}",
                "release_status": "0",
                "update_time": "2021年06月10日 18:33:08",
                "audit_status_name": "下线",
                "update_info_check": 0,
                "level_tag": "B",
                "refuse_advice": "",
                "refuse_reason": "1",
                "refuse_file": "",
                "permission_list": [
                    [
                        "android.permission.ACCESS_COARSE_LOCATION",
                        "获取WIFI定位",
                        ""
                    ],
                    [
                        "android.permission.READ_CALENDAR",
                        "读取日历",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CONTACTS",
                        "修改删除联系人",
                        ""
                    ],
                    [
                        "android.permission.WRITE_CAMERA",
                        "使用摄像头",
                        ""
                    ],
                    [
                        "android.permission.CALL_PHONE",
                        "拨打电话",
                        ""
                    ]
                ],
                "pic_url_material": [
                    {
                        "url": "http://******7983c2.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******a6234f.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    },
                    {
                        "url": "http://******bdabfe.jpg",
                        "width": "1080",
                        "height": "1920",
                        "md5": "7b56****4fdb",
                        "size": "733296"
                    }
                ]
            }
        },
        "pkg_symbol": 1,
        "second_category_name": "便捷生活",
        "third_category_name": "美食外卖",
        "transfer_state": -1,
        "show_active": null,
        "last_version_name": "1.0",
        "same_version_status": 0,
        "first_publish": 0,
        "is_has_reserve": 0,
        "reserve_state": 2,
        "age_level": "3",
        "adaptive_equipment": "4",
        "adaptive_type": "1"
    }
}

失败示例

{
    "errno": 911045,
    "data": {
        "message": "开发者ID和包名不匹配",
        "logid": 2204318265
    }
}

OPPO开放平台API传包能力接入 查询普通包详情

发表于由

OPPO开放平台API传包能力接入 查询普通包详情

更新说明

更新时间更新说明
2022-06-08
请求参数新增age_level、adaptive_equipment、adaptive_type、customer_contact，删除player_customer_email、player_customer_phone、player_customer_qq

接口功能

此接口用于通过包名查询普通包应用的详细信息。

接口原型

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

请求参数

参数类型必传说明
pkg_namestring必传应用包名
version_codestring非必传版本号，默认取最新版本

请求响应

响应说明

字段类型说明
errnoint错误码，为0表示成功
dataDetailBody应用详情，响应结构参考DetailBody

DetailBody

字段类型说明备注
app_idstring应用ID
pkg_namestring应用包名
typeint应用类型，7-普通应用；8-合作游戏；10-合作应用
signstring包签名
dev_idstring应用所属开发者ID
app_secretstring游戏支付 (私钥)
server_secretstring
app_keystring游戏支付key (公钥)
update_timedatetime应用更新时间
app_create_timedatetime应用创建时间
app_namestring应用名称
is_freezestring应用是否被冻结， 0-否；1-是
freeze_reasonstring被冻结原因
refuse_reasonstring审核拒绝原因
tag_liststring游戏标签
is_businessstring是否合作，0-否；1-是
game_typestring应用类型，1 单机；2 网游；3 棋牌；5 超休闲
second_category_idstring二级分类ID
third_category_idstring三级分类ID
copyright_urlstring软件版权证明
special_urlstring特殊类证书
special_file_urlstring特殊类证书压缩包
freeze_filestring冻结附件
business_usernamestring商务联系人姓名
business_emailemail商务联系人邮箱
business_mobilestring商务联系人电话
business_qqstring商务联系人QQ
business_positionstring商务联系人职务
business_addressstring商务联系人地址
freeze_advicestring冻结建议
app_typestringapp类型，0-未设置；1-合作应用
app_real_typestringapp类型，0-非合作状态；1-合作状态
ad_typestring买量游戏类型，1-买量游戏；2-联运买量游戏
dev_namestring
electronic_cert_urlstring电子版权证书
icp_urlstringICP备案网址或备案号
relation_app_idstring关联合作游戏
ascription_typestring游戏归属权，1-自研；2-代理合作游戏返回
authorize_typestring软件著作权登记类型；1-著作权证书合作游戏返回
proxy_contract_urlstring授权合同或协议/代理授权合同或协议合作游戏返回
authorize_urlstring软件著作权登记证合作游戏返回
authorize_descstring软件著作权登记号合作游戏返回
operation_license_urlstring网络文化经营许可证合作游戏返回
approval_doc_urlstring游戏版号证书合作游戏返回
culture_record_urlstring文化部备案文件合作游戏返回
approval_doc_numberstring游戏版号编号合作游戏返回
culture_record_numberstring文化部备案文件编号合作游戏返回
approval_doc_typestring版号有效期类型，1-永久有效；2-固定游戏期合作游戏返回
approval_doc_start_timedatetime版号有效期开始时间合作游戏返回
approval_doc_end_timedatetime版号有效期结束时间合作游戏返回
other_cetificate_urlstring其他补充资质合作游戏返回
absolve_declare_urlstring免责声明合作游戏返回
record_identification_codestring备案识别码合作游戏返回
record_identification_imagestring渠道绑定截图合作游戏返回
version_idstring版本ID
version_codestring版本号
version_namestring版本名称
apk_urlstringapk文件地址
apk_sizestringapk文件大小
apk_md5stringapk文件md5
header_md5string包头部md5
channelstring
package_permissionstring[]应用权限
resolutionstring分辨率
version_typestring版本类型，1-新增；2-更新；3更新资料
create_timedatetime创建时间
min_sdk_versionstring
target_sdk_versionstring
ver_second_category_idstring对应版本二级分类
ver_third_category_idstring对应版本三级分类
release_typestring版本发布类型，1-全量发布；2-分阶段发布；3-内部分阶段发布包
release_over_typestring分阶段结束发布类型，1-分阶段结束全量发布；2-分阶段结束下架
phone_supportstring是否要手机端支持，0-否；1-是
phone_support_versionstring手机端版本要求
ios_linkstring是否支持IOS设备，1-否；2-是
apk_full_urlstringapk文件完整地址
online_typestring发布类型，1-审核立即发布；2-定时发布
sche_online_timedatetime定时发布时间
test_typestring测试类型
test_start_timedatetime游戏内测开始时间
test_end_timedatetime游戏内测结束时间
is_signaturestring是否签名，0-否；1-是
is_pre_downloadstring是否开启预下载，1-否；2-是
langstring语言
icon_urlstring图标url
icon_md5string图标md5
summarystring一句话简介
detail_descstring软件介绍
update_descstring版本说明
app_subnamestring应用副标题
test_descstring测试附加说明
video_urlstring视频地址
pic_urlstring竖屏截图地址
package_permission_descstring包权限描述
video_pic_urlstring视频封面地址
cover_urlstring游戏空间封面图
landscape_pic_urlstring横屏截图地址
privacy_source_urlstring隐私政策网址
release_descstring分阶段发布说明描述
test_urlstring测试文件
english_namestring英文名
regionstring地区
levelstring等级，-1-D；0-C；1-B；2-A
online_timedatetime上架时间
offline_timedatetime下架时间
is_first_publishstring是否首发
business_refuse_reasonstring商务审核打回理由
old_audit_statusstring
release_statusstring分阶段发布状态，0-未设置；1-分阶段发布中；2-暂停分阶段发布；3-取消分阶段发布；4-分布发布阶段结束
refuse_advicestring修改建议
statestring上架状态，1-上架；2-下架
change_statestring是否变更状态，-1-未请求变更；0-业务开启对外更新；1-取消预下载
online_info_offline_applyOfflineApplyInfo[]上架信息，结构参考OfflineApplyInfo
sizestringapk包大小
audit_statusstring审核状态
audit_status_namestring审核状态描述
offline_infostring下架申请信息
transfer_stateint转让状态，-1-无；1-审核通过；2-审核不通过；3-同意接受；4-不同意接受
update_info_checkint更新资料审核状态，1-审核中；0-不在审核中
level_tagstring应用等级标签
refuse_filestring打回附件链接
landscape_pic_url_materialPicMaterialInfo[]横屏截图扩展信息，结构参考PicMaterialinfo
pic_url_materialPicMaterialinfo[]竖屏截图扩展信息，结构参考PicMaterialinfo
video_url_materialVideoInfo[]视频扩展信息，接口参考VideoInfo
age_levelstringAPP年龄分级，示例：3
adaptive_equipmentstring平板适配，4-手机，5-平板，6-手机和平板
adaptive_typestring适配方式，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：周末&节假日服务时间

OfflineApplyInfo

字段类型说明
app_idstring应用ID
version_idstring版本ID
online_statestring上架状态
online_timedatetime上架时间
offline_timedatetime下架时间

PicMaterialinfo

字段类型说明
urlstring图片地址
widthstring图片宽
heightstring图片高
md5string图片md5
sizestring图片大小

VideoInfo

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

响应示例

成功示例

{
    "errno": 0,
    "data": {
        "app_id": "111",
        "pkg_name": "com.foo.bar",
        "type": 7,
        "sign": "38ee****057c",
        "dev_id": "1111",
        "app_key": "f429****efc6",
        "update_time": "2020年09月23日 19:31:05",
        "app_create_time": "2020-03-13 10:16:40",
        "app_name": "测试应用",
        "is_freeze": "0",
        "freeze_reason": null,
        "refuse_reason": "a:1:{i:0;s:24:\"资源下架理由外部\";}",
        "tag_list": null,
        "is_business": "0",
        "game_type": "0",
        "second_category_id": "74",
        "third_category_id": "6685",
        "copyright_url": "http://******2d877341.jpg,,",
        "special_url": "http://******520eabc9.jpg,,",
        "special_file_url": "",
        "freeze_file": null,
        "business_username": "",
        "business_email": "",
        "business_mobile": "",
        "business_qq": "",
        "business_position": "",
        "business_address": "",
        "freeze_advice": null,
        "app_type": "0",
        "app_real_type": "0",
        "electronic_cert_url": "",
        "icp_url": "",
        "relation_app_id": "0",
        "version_id": "111111",
        "version_code": "6091000",
        "version_name": "6.9.1",
        "apk_url": "/apk/202009/23/****eda24.apk",
        "apk_size": "70999067",
        "apk_md5": "0df6****0b53",
        "header_md5": "c3ab****e3ff",
        "package_permission": "android.permission.ACCESS_NETWORK_STATE",
        "resolution": null,
        "version_type": "2",
        "create_time": "2020-09-23 19:36:40",
        "ver_second_category_id": "74",
        "ver_third_category_id": "6685",
        "apk_full_url": "http://******/apk/202009/23/******eda24.apk",
        "online_type": "1",
        "sche_online_time": "2020-03-13 02:32:00",
        "test_type": "0",
        "test_start_time": "0000-00-00 00:00:00",
        "test_end_time": "0000-00-00 00:00:00",
        "player_customer_email": null,
        "player_customer_phone": null,
        "player_customer_qq": "",
        "is_signature": "0",
        "is_pre_download": "1",
        "icon_url": "http://******45cac481.png",
        "icon_md5": "",
        "summary": "xxxxxxxxxxxxxxxxxxxx",
        "detail_desc": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "update_desc": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "app_subname": "AppSubName",
        "test_desc": null,
        "video_url": "",
        "pic_url": "http://******edd338c7.jpg,http://******9dd7b7.jpg,http://******f00521.jpg",
        "package_permission_desc": null,
        "video_pic_url": null,
        "cover_url": null,
        "landscape_pic_url": "http://******10cb6c.jpg,http://******b6a908.jpg,http://******d720a9.jpg",
        "privacy_source_url": "http://foo.bar.com",
        "level": "1",
        "state": "1",
        "online_time": "2020-09-29 19:15:38",
        "offline_time": "2020-09-29 19:12:59",
        "business_refuse_reason": "a:1:{i:0;s:24:\"资源下架理由外部\";}",
        "online_info_offline_apply": [
            {
                "app_id": "111",
                "version_id": "111110",
                "online_state": "1",
                "online_time": "2020-09-29 19:13:07",
                "offline_time": "2020-09-29 17:00:19"
            },
            {
                "app_id": "111",
                "version_id": "111111",
                "online_state": "1",
                "online_time": "2020-09-29 19:15:38",
                "offline_time": "2020-09-29 19:12:59"
            }
        ],
        "size": "67.71 MB",
        "audit_status_name": "上线",
        "offline_info": null,
        "transfer_state": -1,
        "update_info_check": 0,
        "level_tag": "B",
        "refuse_advice": "a:1:{i:0;s:18:\"资源下架理由\";}",
        "refuse_file": "",
        "landscape_pic_url_material": [
            {
                "url": "http://******10cb6c.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "06b9****6d1d",
                "size": "227502"
            },
            {
                "url": "http://******b6a908.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "8fa1****c9e5",
                "size": "558801"
            },
            {
                "url": "http://******d720a9.jpg",
                "width": "1915",
                "height": "1080",
                "md5": "ee9e****ec32",
                "size": "350314"
            }
        ],
        "pic_url_material": [
            {
                "url": "http://******d338c7.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "6c57****6148",
                "size": "396069"
            },
            {
                "url": "http://******9dd7b7.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "f641****5f85",
                "size": "568491"
            },
            {
                "url": "http://******f00521.jpg",
                "width": "1080",
                "height": "1920",
                "md5": "f075****dffa",
                "size": "289818"
            }
        ],
        "video_url_material": [],
        "age_level": "3",
        "adaptive_equipment": "4",
        "adaptive_type": "1",
        "customer_contact": "[{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"1\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"13928452035;95533\"},{\"weekend_hours\":\"00:00-23:59\",\"contact_method\":\"2\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"support@cat-studio.net;496228536@163.com\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"3\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"496228536;921440223\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"4\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"王者荣耀公众号123_honor\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"5\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"1bbb_235\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"6\",\"working_hours\":\"08:30-18:30\",\"contact_info\":\"吃鸡公众号_123child\"},{\"weekend_hours\":\"09:30-18:00\",\"contact_method\":\"7\",\"working_hours\":\"08:30-08:00\",\"contact_info\":\"13928452035字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字汉字\"}]"
    }
}

失败示例

{
    "errno": 911045,
    "data": {
        "message": "开发者ID和包名不匹配",
        "logid": 2204318265
    }
}

OPPO开放平台API传包能力接入 文件上传

发表于由

OPPO开放平台API传包能力接入 文件上传

上传流程说明

1）请求 获取上传配置 接口实时获取上传的请求 URL 和 sign。

2）请求 upload_url，参数为 文件上传 接口列出的参数，sign 是一次性的，每上传一个文件都需要重新获取一次。

获取上传配置

接口功能

此接口用于获取上传文件配置。

接口原型

-请求路由：/resource/v1/upload/get-upload-url
-请求方法：GET
-请求类型：Content-Type: x-www-form-urlencoded

请求参数

只需传入公共参数。

请求响应

响应说明

字段类型说明
errnoint错误码，为 0 表示请求成功
dataPreUploadBody响应结果，结构参考 PreUploadBody

PreUploadBody

字段类型说明
upload_urlstring文件上传 URL
signstring一次性标识，单次有效，每个新文件必须重新获取

响应示例

成功示例
{
    "errno": 0,
    "data": {
        "upload_url": "https://oppo.com/xxxxxxxxx",
        "sign": "b1fe****ad13"
    }
}

文件上传

接口功能

此接口用于上传文件。

接口原型

  • 请求 URL：接口获取上传配置返回的 upload_url
  • 请求方法：POST
  • 请求类型：Content-Type: multipart/form-data

请求参数

字段类型是否必传说明
typestring是文件类型，包括照片、APK 包、其它，值是：photo、apk、resource
signstring是一次性标识，从获取上传配置返回的 sign 字段，单次有效，每个新文件必须重新获取
filebinary是文件对象

请求响应

响应说明

字段类型说明
errnoint错误码，为 0 表示请求成功
datamap响应结果，参考 UploadObj

UploadObj

字段类型说明
urlstring文件地址（带域名）
uri_pathstring文件 URI（不带域名）
md5string文件 MD5
file_extensionstring文件扩展名
file_sizeint文件大小
idstring标记
widthint图片宽度（只有图片才有）
heightint图片高度（只有图片才有）

响应示例

成功示例

APK 类型
{
    "errno": 0,
    "data": {
        "url": "https://oppo.com/********261d.apk",
        "uri_path": "/********261d.apk",
        "md5": "5efd****4d4d",
        "file_extension": "apk",
        "file_size": 4181241,
        "id": "XXXXX"
    }
}
图片类型
 {
     "errno": 0,
     "data": {
         "url": "http://oppo.com/********d47d.jpg",
         "uri_path": "/********d47d.jpg",
         "md5": "55e3****1084",
         "sign": "eee4****bce4",
         "width": 1080,
         "height": 1920,
         "file_extension": "jpg",
         "file_size": 598879
     }
 }
resource
{
    "errno": 0,
    "data": {
        "url": "http://oppo.com/********a936.pdf",
        "uri_path": "/********a936.pdf",
        "md5": "d557****4931",
        "sign": "b384****821f",
        "file_extension": "pdf",
        "file_size": 15106
    }
}

失败示例

-sign 过期或不合法，需要重新调用接口获取 sign

{
    "errno": 910003,
    "data": {
        "message": "Unauthorized upload [1]",
        "logid": 2965369111,
        "ext": []
    }
}

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传包能力接入 获取任务状态

发表于由

OPPO开放平台API传包能力接入 获取任务状态

获取任务状态

接口功能

此接口用于获取 补充资源信息 接口任务处理状态。

接口原型

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

请求参数

字段类型是否必传说明
pkg_namestring是要查询的包名
version_codestring是版本号

请求响应

响应说明

字段类型说明
errnoint错误码，为 0 表示请求成功
dataTaskBody响应结果，结构参考TaskBody

TaskBody

字段类型说明
pkg_namestring包名
version_codestring版本号
task_statestring状态，1-待处理；2-处理成功；3-处理失败
err_msgstring错误原因

响应示例

成功示例

{
    "errno":0,
    "data":{
        "pkg_name":"com.foo.bar",
        "version_code":"123",
        "task_state":"3",
        "err_msg":"您上传的 apk 中的包名 com.test.foo 与当前应用包名不一致，请重新上传"
    }
}

失败示例

{
    "errno":911023,
    "data":{
        "message":"应用不存在",
        "logid":4138794965
    }
}

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开放平台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
    }
}

OPPO开放平台API传包能力接入

发表于由

OPPO开放平台API传包能力接入

能力介绍

通过接入API传包能力，您可以在内部系统实现一键发布应用、更新版本、更新资料、查询应用最新详情等，无需每次前往OPPO开放平台管理中心页面进行操作，能够节省人力，提高上架效率。
接入前建议您详细阅读帮助文档，按照流程和说明接入，如有疑问可以咨询在线客服。

注意：目前API传包能力面向普通应用、合作应用、合作游戏的开发者开放。

接入流程

API 调用方法详解

API调用是基于HTTP协议的。

调用流程：请求获取Access Token接口 -> 存储token（48小时有效） -> 拼接参数进行签名 -> 发起HTTP请求 -> 得到HTTP响应

调用注意事项：

所有的请求及响应数据编码均为utf-8格式；URL里的所有参数名和参数值都需进行URL编码。如果请求的Content-Type为application/x-www-form-urlencoded，则HTTP请求体里的所有参数值也做URL编码；如果是multipart/form-data格式，每个表单字段的参数值无需编码，但每个表单字段的charset部分需要指定为utf-8。

无特殊说明时，一般请求的 Content-type 为 application/x-www-form-urlencoded。

接口域名

正式环境：https://oop-openapi-cn.heytapmobi.com

获取Access Token

首先需要登录OPPO开放平台，获取客户端ID和密钥（若为团队帐号，需使用管理员帐号登录）。

具体路径：OPPO开放平台→管理中心→应用服务平台→API密钥管理→创建客户端→获取客户端ID、密钥。

调用业务接口前需先获取授权token (access token)，用于后续参数签名，开发者需要进行妥善保存。

Access token的有效期为48小时，超过有效期后需重新获取；在token过期前可重新调用接口获取新的access token（48小时有效），旧的access token将在5分钟内过期。

接口请求

-请求路由：/developer/v1/token
-请求方法：GET
-请求参数：

获取access token接口参数为：

参数名称参数类型是否必须参数描述
client_idstring是OPPO开放平台申请分配的client_id，18位字符串
client_secretstring是OPPO开放平台申请分配的client_secret，与client_id配对，64位字符串

通过发起HTTP Get请求，在URL中携带client_id与client_secret参数，可获取一次性access token。

  • 接口响应：
{
    "errno": 0,
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE2MTU1MzE2NDYsInN1YiI6Ik9QUE8tT09QLU9QRU5BUEkiLCJuYmYiOjE2MTUzNTg4NDYsImF1ZCI6Im9wcG8tb29wIiwiaWF0IjoxNjE1MzU4ODQ2LCJqdGkiOiJ4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4Iiwic3RhdHVzIjoxLCJkYXRhIjp7ImNsaWVudF9pZCI6IjEqKioqKioqKioqKioqKioqKjAifX0.fNsW1gp7EIDRGw4-aHKCMJGIsRLO_FuR1BOcGAUwq7c",
        "expire_in": 1615531646
    }
}
  • 响应说明：
参数名称参数类型参数描述
access_tokenstring返回的续期access token，48小时有效
expire_inintUnix时间戳，token将于此时过期

公共参数

除获取授权token外，调用任何一个API都必须传入的参数：

参数名称参数类型是否必须参数描述
access_tokenstring是鉴权接口返回的限期access_token
timestampstring是时间戳（秒级）示例：1609401600，允许客户端请求最大时间误差为15分钟
api_signstring是API输入参数签名结果，签名算法参照下面的介绍

签名方法

API签名计算规则为涉及的所有请求参数（包含get参数和POST参数，例如请求参数k1=v1,参数k2=v2）

step 1：请求参数（除api_sign外的公共参数+业务参数）按照ASCII升序排序

step 2：请求参数使用&拼接字符串，值为null的参数不参与签名，拼接成k1=v1&k2=v2

step 3：对step3得到的字符串进行HmacSHA256计算，计算时使用的密钥key为获取access token时与client_id配对的client_secret

step 4：将hash计算结果转换为小写16进制，得到签名sign。

签名代码示例：点击下载签名demo

OPPO Sign获取指引

发表于由

什么是 OPPO Sign

OPPO Sign是应用的签名摘要信息通过OPPO的加密算法生成的MD5字符串，主要用于接入OPPO帐号、游戏SDK时候做应用身份校验。

什么场景需要 OPPO Sign

同时符合如下两个条件的应用需要填写OPPO Sign
1、需要接入帐号SDK或者游戏SDK。
2、未发布的应用（上传应用APK后我们会自动根据前面信息计算出对应的OPPO Sign信息，因此只需要未发布的应用填写OPPO Sign）。

如何获取OPPO Sign

您可以选择在PC端（Windows）或者手机端（Android）去获取安装包的签名摘要信息。

Windows 获取指引

1）下载OPPOSign.zip；

2）解压文件，然后在电脑上运行OPPO Sign程序；

3）按照操作指引拖入APK文件；

4）获取到OPPO Sign，复制文本。

手机端获取指引

1）在手机上安装所需要获取OPPO Sign的应用；
2）在手机上安装获取签名工具；
3）打开获取签名工具，输入所需获取OPPO Sign应用的包名，点击“获取签名信息”。

OPPO开放平台边下边玩接入指引

发表于由

OPPO开放平台边下边玩接入指引

什么是“边下边玩”

边下边玩是一种由OPPO软件商店提供的能力，它可以通过对软件包体进行分析，得到运行必要的模块与非必要模块。在用户安装的时候，会先传输必要的模块，当必要模块传输完成后，用户就可以启动应用进行使用，非必要模块会在用户使用的过程中逐块传输，以实现一边下载一边玩的能力。

如何接入“边下边玩”能力

“边下边玩”能力的功能完全由OPPO实现。作为开发者，您无需进行任何额外的开发，仅需提供一个V4签名即可（部分开发者无需提供，见下文）。

申请加入公测

当前边下边玩能力处于内测阶段，并未面向所有开发者和所有用户开放，如果您想要参与内测，请向我们提出申请。由于并非所有应用都会有良好的边下边玩表现（这与应用的实现方式密切相关），我们会选拔出表现相对较好的应用发布线上进行内测。

申请方式：
应用请发送邮件至：g_lyyunying@oppo.com，
游戏请发送邮件至：g_game_bd@oppo.com。
邮件正文如下：
1）应用名称：
2）应用包名：
3）应用ID：
4）开发者名称：
5）您是否愿意配合OPPO一起优化边下边玩功能：
6）您的应用（最新版本）是否符合以下条件：

条件是否满足
应用安装后不做大量资源解压缩（小于包体大小30%）是/否
应用安装后不做大量资源校验（小于包体大小30%）是/否
应用安装后不需要额外下载较大资源包是/否
应用拥有比较固定的使用流程（比如关卡游戏）是/否
如果是游戏，是否为单机游戏（应用无需填写）是/否

如果您的应用符合以下条件，我们十分建议您申请开通能力，因为您的应用更有可能在边下边玩中表现的更好：

1）应用安装后不做大量资源解压缩（小于包体大小30%）；
2）应用安装后不做大量资源校验（小于包体大小30%）；
3）应用安装后不需要额外下载较大资源包；
4）应用拥有比较固定的使用流程（比如关卡游戏）。
5）如果应用是游戏，则单机游戏可能会拥有更好的体验。

这些并不是强制项，如果您的应用无法满足以上多个条件，但您依旧想使用边下边玩技术，您依然可以向我们发送申请，我们会进行评估，并与您持续沟通。

上传应用的V4签名

如果您的申请已通过，但没有上传入口，则说明您的应用无需上传签名即可拥有边下边玩能力。

当您的测试申请被批准后，在OPPO开放平台的应用资料更新页面就会出现V4签名的上传入口。

上传您的V4签名（点击查看如何给应用签V4签名），通过检验后提交即可。

当前有部分合作游戏无需上传V4签名，仅需加入内测名单即可，其他类型的应用则需要上传V4签名。

等待应用审核上架

当您的应用审核上架通过后，OPPO软件商店会对您的应用进行分析预测。分析结束后，用户在安装该应用的过程中就可以体验到边下边玩能力了。

“边下边玩”能力支持范围

终端软件商店版本：>= 9.0.75
终端Android版本：>= Android S
支持终端：目前仅支持手机

为什么我的应用“边下边玩”体验不佳？

这说明您的应用基础块依赖较多，用户需要下载较大比例才可以进入游戏。您可以尝试按照以下方向进行优化更新：
1）避免安装启动后的大量资源解压缩
2）避免安装包内置的资源digest校验
3）按需加载文件，规避首次启动后短时间内的大量文件使用

如果您有其他疑问，请联系我们。

为什么我开启了“边下边玩”，用户端却无法体验？

这可能是由于以下原因：
1）用户端未在设置中开启边下边玩能力。
2）您的应用包仍在分析分块中。
3）您的应用在边下边玩的系统测试中表现一般，未达到下发标准。
4）为了保证数据完整性和系统稳定性，我们只允许用户终端在同一时刻存在一个边下边玩应用。
5）用户的终端版本不符合要求或者未被选中为内测用户。

OPPO开放平台素材AB算法推荐

发表于由

OPPO开放平台素材AB算法推荐

素材AB算法推荐

能力说明

开发者上传的素材，支持算法进行千人千面推荐，根据效果智能决定展示量级；只需要开发者上传素材，后续直接交给算法，无需过多操作，不需要人工频繁基于效果调整实验计划，或设置最终素材。

建议配置方法：建立算法推荐任务，并上传素材后，设置【无限天数】，把基于效果调整素材的能力交给算法。

新旧能力对比

流程现状新能力上线后
素材AB（非算法推荐）单个素材流量：随机分流
最终素材决策：测试完成后，需要人工基于数据选出效果最好的素材，设置为默认素材		保持一致
素材AB（算法推荐）/单个素材流量 & 最终素材决策：
算法进行个性化推荐，且根据效果智能决定展示量级。 素材ab
整体流量占比配置非算法推荐+默认素材=100%流量非算法推荐+算法推荐+默认素材=100%流量

配置流程

进入ABTest功能页面

找到开放平台内【应用详情】页面，下拉找到【素材ABTest】入口并进入，选择【上架期间素材ABTest】。

新建算法推荐测试任务

添加新素材AB任务

在【上架期间素材ABTest】页面内，点击【添加新素材AB任务】。

注：非算法推荐 & 算法推荐测试组，分别只能运行一组。如需要新建任务，需要先把原任务结束掉。

时间 & 流量设置

填写任务基本信息后点击下一步，要填写的信息包括：
· 素材名称
· 测试类型 （选择“算法测试类型”）
· 测试天数 （可选择无限天数，因算法会智能根据素材效果，分配展示量级，无需开发者手动查看效果后，进行上下线；也可选择有限天数）
· 测试流量范围
算法推荐测试组，整体流量范围可在0%到100%中调整，并且算法推荐+非算法推荐的整体流量，不可超过100%。

示例：
非算法推荐流量设置为40%，算法推荐流量设置为40%，剩下20%流量默认展示主素材。
非算法推荐流量设置为40%，算法推荐流量设置为60%，则无剩余流量展示主素材。

素材设置

算法推荐测试组中，开发者可创建不同素材，进入算法推荐环节。具体操作说明如下：
· 添加方案：点击【添加方案】，将新建一套方案。
· 素材复制：点击页面右侧【复制】按钮，可复制出一套新素材，其中内容仍与主素材保持一致。做多组实验的时候，开发者可复制多套素材，并针对单独内容进行更换，无需重复多次上传。
· 数量限制：除主素材外，算法推荐测试任务，最多可创建8套素材，与此前的非算法推荐素材ab功能保持一致。
· 名称 & 流量编辑：进入方案页面，仍可针对素材套餐名称、流量范围进行编辑。
· 提交审核：创建完毕之后，点击提交审核。

结束测试

素材通过审核上线后，如需要中止实验，可在测试方案详情页内，选择完成测试，并结束测试。

数据回收

点击任务内右侧【数据】入口，或进入【生态服务-应用服务-应用分析-运营分析-素材ABTest】页面，均可看到不同任务的数据效果，指标包括：
icon点击率、icon转化率、详情页转化率，后续将添加上icon曝光次数、详情页曝光次数，便于开发者观测到算法分配给不同素材的展示量级，以及量化整体效率。

OPPO开放平台应用素材 AB test 功能介绍

发表于由

OPPO开放平台应用素材 AB test 功能介绍

产品简介

素材ABtest即产品素材测试，简单来说，就是为一款产品提供多套素材测试，通过给不同用户展示不同素材，收集各套素材的日志数据，帮助开发者选择最优的产品曝光素材。

素材ABtest功能，面向所有应用开发者开放，开发者申请需满足在OPPO应用分发广告业务连续投放一星期以上，符合此条件的开发者可联系营销顾问或对应的客户运营（点击查看联系方式）邮件申请开通该功能入口的权限。开通此权限以后，需保持连续投放2周以上，如果在此期间停投则关闭权限。

使用场景

素材ABtest适用于有优化详情页素材转化效果需求的广告主，为他们提供多套详情页素材测试，通过给不同用户展示不同素材，收集各套素材的日志数据，帮助开发者选择最优的产品曝光素材。

申请权限

1） 邮件申请：

邮件中需包含应用全称、应用ID、应用包名、应用当前包体状态、企业名称信息，收件人为对应的营销顾问或客户运营（点击查看联系方式），邮件格式内容如下：

邮件标题：应用素材ABtest权限申请-应用名称-企业名称
邮件正文：
应用全称：
应用ID：
应用包名：
应用当前包体状态：
企业名称：

2） 权限开通：
邮件发送之后，一般2-3个工作日会进行审核，通过后权限即自动生效。

操作指引

操作路径（只有权限开通后，才会展示操作入口）

备注：应用当前包体处于“上线”状态，素材ABtest路径入口是开放状态，当包体状态处于审核/资料更新等状态下时，测试素材会跟包体冲突，会暂时屏蔽“素材ABtest”入口，所以找不到入口时，请先检查应用当前状态。

测试流程

流程说明：
1）开放平台上传素材，含应用ICON、一句话描述、五图、详情页背景图，设置测试时间，素材任务提交，进行送审；
2）审核通过之后，第二天零点自动上架开始测试，次日出数据；
3）测试结束之后，可以选择数据最优的素材替换为线上素材，自动替换后一键生效，毋须重新审核；

操作指引

3.1、第一部分：素材ABtest测试

3.1.1、测试内容

应用ICON、一句话描述（仅游戏特有）、详情页五图、详情页背景图

3.1.2、出图说明：

1）应用icon：尺寸：512512px，图片格式：PNG，小于1M；
2）应用详情页展示截图：3-5张截图，支持JPG、PNG格式。截图尺寸要求：10801920，单张图片不能超过1M。去除截图中的顶部状态栏的通知图标，图片中不得使用其他品牌的手机作为边框或宣传图；
3）详情页背景图：尺寸：1080x1476px，图片格式：jpg，小于500K。具体规范如下图所示：

3.1.3、上传路径

素材ABtest入口上传

1）素材ABtest测试，是按照素材任务套餐上传，见下图：

注意：APP当前测试任务套餐状态未结束时，不能添加新套餐；

2）创建套餐：需要输入素材任务名称和测试天数，见下表：

注意：套餐名称限制字数为10（含符号），测试天数可选择1-5天；

3）添加新素材：每个测试任务最多添加5套素材

素材设计参考上面的“出图说明”，上传完毕可以生成预览图，预览效果如下：

预览环境检查上传素材是否满足要求：

注意：

· 预览和保存，因涉及的素材较多，可能会有几秒钟延迟，请理解；

· 定制背景图，只支持合作游戏和应用合作，普通应用请选择“头图-banner”、无背景图/头图选择“无”；

· 测试任务提交审核，任务列表会显示当前任务状态，审核状态素材不支持修改

· 素材生效：审核通过之后，次日凌晨自动上线生效；

3.2、第二部分：查看数据&素材替换

1）素材生效，次日可以查看数据，测试完成，可查看完整数据；

2）根据当前测试素材，可以选择最优素材替换为线上生效素材，当前测试结果不理想，没有需要替换的素材，需要终止任务，才能开始下一次任务测试；

注意：素材ABtest设置的主素材有效期为90天，90天结束后素材会自动下架，自动回滚到更换前的主素材。

OPPO开放平台APP多包上传教程

发表于由

OPPO开放平台APP多包上传教程

业务介绍

1、能力介绍：多包发布能力可实现为应用发布多个不同的APK，每个APK针对不同的设备CPU架构下发。
2、包体介绍：每个APK都是完整、独立的应用版本，且需共享相同的软件名称、使用相同的发布密钥进行签名。

典型应用场景

支持不同的CPU架构，分别为32位、64位。通过在不同架构设备上提供不同版本，可实现减小包体体积，一般对低端机提供32位版本，对主流机型提供64位版本优化内存使用问题。适用于对不同设备提供差异化功能的开发者。

上传多包流程

1）登录OPPO开放平台开发者帐号，进入管理中心→应用服务平台→移动应用列表→应用详情页，点击“多CPU包能力”。


2）仔细阅读操作须知，然后点击“使用多CPU包上传能力”，弹框中点击“确定”。

3）进入发布应用或版本升级页面，按照提示分别上传32位和64位APK包。

4）如需从多包上传转换为普通包上传，请进入应用详情页→多CPU包能力→使用普通包上传能力。后续转换能力需要联系在线客服并由人工审核，请慎重操作

使用限制

1）软件包名和签名必须一致；

2）支持拆分维度：CPU架构；

3）多包应用的软件包作为整体发布，所有包审核通过才通过；

4）新版本上架后，上一版本所有软件包下架；

5）新增或更新多包时，32位包版本号≤64位包版本号。

FAQ

1）什么是32/64位兼容安装包？
A：32/64位兼容安装包指既能支持32位手机系统又同时支持64位手机系统的安装包。

2）同时上传32/64位安装包需要注意什么？

A：同时上传32位、64位安装包需要在多包入口进行上传，且需要保障32位、64位安装包包名、签名一致，同时32位包版本号≤64位包版本号，软件商店会对两个包体独立进行审核。具体操作详见多包上传流程。

3）适配后，用户在软件商店搜索是否会出现2个同样的应用？

A：双包上传后，用户不会在软件商店搜索到2个同样的应用，商店对每个APK会针对不同的设备CPU架构进行下发，即32位应用下发32位CPU架构设备，64位应用下发64位CPU架构设备。

4）若应用仅支持64位包，如何操作？

A：若为第一次在软件商店上传该应用，则暂不支持64位包；若非第一次在软件商店上传该应用，则走多包上传入口，仅传64位包即可。为保障用户体验，建议提供32位CPU架构用户可使用的包。

5）若使用多包后，后续不想用多包能力进行上传了怎么操作？

A：在多包上传界面有申请转普通包上传的入口，第一次申请无需审核，可秒转普通包上传；第二次及以后申请变为多包上传需走申请，申请通过后方可再变换上传方式。