创建批量更新APP的任务
批量修改APP信息时,可能需要下载APK文件,因此使用添加离线任务的方式。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/app/updateTask
字段 |
类型 |
必须 |
描述 |
apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin。 |
Body请求参数
字段 |
类型 |
必须 |
描述 |
apps |
JSON |
Yes |
JSON 格式的APP对象数组,单次请求提交的对象数量最多100个。 |
apps 请求示例
[
{
"appId": 6790793322,
"title": "app名称",
"imageEncode": "base64EncodedString3",
"appUrl": "http://example.com/app3",
"developer": "http://example.com/developer",
"privacyUrl": "http://example.com/privacy",
"authUrl": "http://example.com/auth",
"copyrightEncode": "base64EncodedString,base64EncodedString",
"appAutoCheck": "ON",
"remark": "app备注"
}
]
apps 字段说明
字段 |
类型 |
必须 |
描述 |
appId |
String |
Yes |
应用id,可通过批量获取APP信息 接口获得 appId |
title |
String |
No |
APP名称长度限制为 2 ~ 50 个字符 |
imageEncode |
String |
No |
APP图标(图片base64编码) |
appUrl |
String |
No |
APP下载链接 |
appAutoCheck |
String |
No |
是否自动检测APP下载链接更新(仅限安卓APK包的下载链接使用),枚举值:ON或OFF,ON-开启; OFF-关闭,缺省值为OFF |
developer |
String |
No |
开发者名称(仅限系统类型为Android时使用,且必填) |
privacyUrl |
String |
No |
隐私协议url(仅限系统类型为Android时使用,且必填) |
authUrl |
String |
No |
用户权限url(仅限系统类型为Android时使用,且必填) |
copyrightEncode |
String |
No |
版权证明(图片base64编码,仅限系统类型为Android时使用,且必填),多张图片使用英文逗号分隔,最多可上传20张图片,文件格式为JPG、JPEG、PNG,大小不超过2M |
remark |
String |
No |
描述, 长度限制为 100 个字符以内 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'apps=[{"appId": 6790793322, "title": "app名称"}]' \
'https://api.e.360.cn/dianjing/app/updateTask'
正常返回结果
{
"appTaskId": 120005,
"failures": []
}
返回结果说明
字段 |
类型 |
描述 |
appTaskId |
Number |
APP离线任务id,用于获取任务处理状态 |
failures |
Json |
失败任务详细信息 |