搜狗首页  |   服务首页  |   客服热线:010-56898080

计划服务  |  计划服务(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": ""//
            }
        ]
    },
    // 公共响应
}