承载协议 | HTTPS POST |
|---|---|
接口方向 | 开发者服务器->推广平台服务端 |
接口URL | https://connect-api.cloud.huawei.com/api/marketing-api/v2/query/subTaskList |
数据格式 | 请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
参数 | 必选(M)/可选(O) | 类型 | 描述 |
|---|---|---|---|
client_id | M | String | 客户端ID,获取方法参考创建API客户端。 |
Authorization | M | String | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token的获取方式请参见获取Token。 |
参数 | 必选(M)/可选(O) | 类型 | 描述 |
|---|---|---|---|
customerId | O | String | 授权合作伙伴投放时必须携带;在直客团队体系中,可通过直客协作者账户ID查询协作者账户列表,未传入协作者账户ID时,返回直客管理者账户的数据。 投放操作者账户/直客协作者账户登录华为应用市场应用推广平台,在右上角账号信息--账户ID获取。 |
subTaskName | O | String | 子任务名称,支持模糊查询。 |
subTaskStatus | O | List<String> | 子任务状态。 |
appId | O | String | 应用ID。 |
deliveryMode | O | Integer | 投放模式。 取值范围:
|
taskType | O | List<String> | 任务类型。 取值范围:
|
pricingType | O | List<String> | 计费类型。 取值范围:
|
conversionBehaviorId | O | String | 转换目标。 取值范围:
|
subTaskKey | O | String | 搜索词。 |
subTaskKeyMatchType | O | String | 匹配类型。 取值范围:
|
subTaskRtaId | O | String | RTA ID。 |
page | O | Integer | 子任务列表页页数。 |
pageSize | O | Integer | 单页任务条数。 取值范围:[1,200] |
POST https://connect-api.cloud.huawei.com/api/marketing-api/v2/query/subTaskList
client_id: ***
Authorization: Bearer ***
Content-Type: application/json
{
"subTaskName": "querySubTask",
"appId": "546215",
"deliveryMode": 0,
"pricingType": ["OCPD"],
"page": 1,
"pageSize": 20
} 参数 | 必选(M)/可选(O) | 类型 | 描述 |
|---|---|---|---|
code | M | Integer | 返回码。 具体请参见错误码。 |
msg | M | String | 返回描述。 |
totalCount | O | Integer | 总数。 最大长度64。 |
subTaskDetail | O | List<SubTaskDetailExt> | 失败任务原因说明。 |
{
"code": 20770001,
"msg": "Success",
"totalCount": 1,
"subTaskDetail": [
{
"subTaskId": 563324,
"subTaskName": "querySubTask",
"subTaskPrice": 20.0,
"subTaskStatus": "ON",
"subTaskPricingType": "OCPD",
"taskId": 533315
}
]
} “Curl”
curl -X PUT https://connect-api.cloud.huawei.com/api/marketing-api/v2/task/status -H "Authorization:Bearer ***" -H "client_id:***" -H "Content-type: application/json" -d '{"code":20770001,"msg":"Success","totalCount":1,"subTaskDetail":[{"subTaskId":563324,"subTaskName":"querySubTask","subTaskPrice":20.0,"subTaskStatus":"ON","subTaskPricingType":"OCPD","taskId":533315}]}'