|
|
计划服务 | 计划服务（Restful）
更新推广计划 ( 可批量 )
通过 updateCpcPlan() 方法，您可以更新除 cpcPlanId 和 status 属性的外的任何一个属性。在调用该方法前，您需要首先构造一个 CpcPlanType 对象。设置该对象的属性为您所需要的值，然后把该对象传递给 updateCpcPlan() 方法即可。如果您在一次请求中，不想更新推广组的某些属性 ( 如 cpcPlanName 、投放地区等 ) ，可把这些属性置为 NULL 即可。服务器端会忽略属性值为 NULL 的更新。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/updateCpcPlan
请求参数体：
{
"body": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"cpcPlanName": "",//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": "",//
"joinUnion": "",//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0,//
"opt": ""//
}
]
},
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"cpcPlanName": "",//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": "",//
"joinUnion": "",//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0,//
"opt": ""//
}
]
},
// 公共响应
}
|
getCpcPlanByCpcPlanId
根据指定的计划 id 获取推广计划 (id 可批量 )
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/getCpcPlanByCpcPlanId
请求参数体：
{
"body": {//
"cpcPlanIds": []//
},
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": "true",//
"joinUnion": "true",//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0,//
"opt": "",//
"cpcPlanName": ""//
}
]
},
// 公共响应
}
|
getAllCpcPlanId
该方法获取 SOAPHeader 中 username 下所有的计划 ID。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/getAllCpcPlanId
请求参数体：
{
"body": {},//
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {//
"cpcPlanIds": []//
},
// 公共响应
}
|
getAllCpcPlan
获取 SOAPHeader 中 username 下所有的计划。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/getAllCpcPlan
请求参数体：
{
"body": {},//
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"opt": {},//
"cpcPlanName": "",//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": false,//
"joinUnion": false,//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0//
}
]
},
// 公共响应
}
|
删除指定的计划 ( 可批量 )
通过 deleteCpcPlan() 方法，您可以删除您账户下的一个或者多个推广计划。推广计划被删除后，其名下的推广组、关键词、创意数据均会被同时删除。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/deleteCpcPlan
请求参数体：
{
"body": {//
"cpcPlanIds": []//
},
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {},//
// 公共响应
}
|
新增推广计划 ( 可批量 )
通过 addCpcPlan() 方法，您可以在您的账户下添加新的推广计划。在调用该方法前，您首先需要构造 CpcPlanType 对象，并设置该对象的必要的属性。 ( 详情请见下面的 API 参考 ) 添加成功后，您可以获得新增推广计划的 id ，此 id 全局唯一。您可以根据此 id 对推广计划进行更新 / 删除操作。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcplan/addCpcPlan
请求参数体：
{
"body": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"cpcPlanName": "",//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": "",//
"joinUnion": "",//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0,//
"opt": ""//
}
]
},
"header": {//
"adType": 1,//
"agentpassword": "",//
"agentusername": "",//
"apiusertype": "",//
"password": "",//
"token": "",//
"username": ""//
}
}
|
响应结果：
{
"data": {//
"cpcPlanTypes": [//
{
"cpcPlanId": 0,//
"cpcPlanName": "",//
"budget": 0,//
"regions": [],//
"excludeIps": [],//
"negativeWords": [],//
"exactNegativeWords": [],//
"schedule": [//
{
"weekDay": 0,//
"startHour": 0,//
"endHour": 0//
}
],
"budgetOfflineTime": [//
{
"flag": 0,//
"time": ""//
}
],
"showProb": 0,//
"pause": "",//
"joinUnion": "",//
"unionPrice": 0,//
"mobilePriceRate": 0,//
"status": 0,//
"opt": ""//
}
]
},
// 公共响应
}
|
|