|
|
关键词服务 | 关键词服务（Restful）
updateCpcInput
修改关键词输入流信息
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/updateCpcInput
请求参数体：
{
"body": [
{
"cpcId": "",
"appUrl": "",
"appPackageName": ""
}
],
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": [
{
"appPackageName": "",
"appUrl": "",
"cpcId": ,
}
],
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
updateCpc
通过 updateCpc() 方法，您可以更新关键词的属性。在更新之前需要创建 CpcType 类型的对象，设定该对象的 cpcId 值和其它所需要更新的属性， 设置完成后即可调用 updateCpc() 进行关键词属性的更新。由于计算关键词状态需要一些时间，所以有可能造成返回的状态信息延迟，请耐心等待。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/updateCpc
请求参数体：
{
"body": {//
"cpcTypes": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"cpcTypes": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcIdByCpcGrpId
根据推广组 id 获取该推广组下所有的关键词数据；由于计算关键词状态需要一些时间，所以有可能造成返回的状态信息延迟，请耐心等待。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/getCpcIdByCpcGrpId
请求参数体：
{
"body": {//
"getTemp": 0,//
"cpcGrpIds": []//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"cpcGrpCpcIds": [//
{
"cpcGrpId": 0,//
"cpcIds": []//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcByCpcId
根据指定的关键词 id 获取关键词。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/getCpcByCpcId
请求参数体：
{
"body": {//
"getTemp": 0,//
"cpcIds": []//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"cpcTypes": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcByCpcGrpId
根据指定的推广组 id 获取关键词 ( 推广组 id 可批量 ) 。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/getCpcByCpcGrpId
请求参数体：
{
"body": {//
"cpcGrpIds": [],//
"getTemp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"cpcGrpCpcs": [//
{
"cpcGrpId": 0,//
"cpcTypeDtos": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
deleteCpc
通过 deleteCpc() 方法，以关键词 id 为参数，您可以删除指定的一个或多个关键词。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/deleteCpc
请求参数体：
{
"body": {//
"cpcIds": []//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"response": ""//
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
addCpc
通过 addCpc() 方法，您可以在您的推广组下增加新的关键词。关键词使用 CpcType 类型表示。在新增关键词前，您首先需要创建 CpcType 类型的对象，并设置该对象必须的属性。 ( 详情请见下面的 API 参考 ) 构造完成合适的 CpcType 对象后，即可调用 addCpc() 方法添加该关键词到指定的推广组中。添加成功后，您可以获得新增关键词的 id ，此 id 全局唯一。您可以根据此 id 对关键词进行更新 / 删除操作。 该接口支持批量增加关键词，您可在一次请求中批量添加多个关键词。由于计算关键词状态需要一些时间，所以有可能造成返回的状态信息延迟，请耐心等待。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpc/addCpc
请求参数体：
{
"body": {//
"cpcTypes": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": xxxxxx"
}
}
|
响应结果：
{
"data": {//
"cpcTypes": [//
{
"cpcId": 0,//
"opt": {},//
"cpcGrpId": 0,//
"cpc": "",//
"price": 0,//
"visitUrl": "",//
"matchType": 0,//
"cpcQuality": 0,//
"pause": false,//
"status": 0,//
"isShow": 0,//
"mobileVisitUrl": ""//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
|