|
|
附加创意服务 | 附加创意服务（Restful）
updateExtraIdea
注：此方法在更新的时候是一个整体，所有属性必须全部填写，如果某一属性不想更新，需将其置为null。
方法说明：通过 updateExtraIdea() 方法，您可以更新附加创意的属性。在更新之前需要创建 CpcExIdeaType 类型的对象，设定该对象的cpcExtraIdeaId 值和其它所需要更新的属性，设置完成后即可调用updateExtraIdea() 进行附加创意属性的更新。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcextraidea/updateExtraIdea
请求参数体：
{
"body": {//
"extraIdeas": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
],
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
queryById
根据指定的附加创意 id 获取附加创意。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcextraidea/queryById
请求参数体：
{
"body": {//
"exIdeaIds": [],//
"temp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
],
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
queryByGrpId
根据指定的推广组 id 获取附加创意。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcextraidea/queryByGrpId
请求参数体：
{
"body": {//
"groupIds": [],//
"temp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": [//
{
"cpcGrpId": 0,//
"cpcExIdeaTypes": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
]
}
],
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
deleteExtraIdea
通过 deleteExtraIdea() 方法，以附加创意 id 为参数，您可以删除指定的一个或多个附加创意。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcextraidea/deleteExtraIdea
请求参数体：
{
"body": {//
"exIdeaIds": []//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": {//
"Object": {}//
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
addExtraIdea
通过 addExtraIdea() 方法，您可以在您的推广组下增加附加创意。CpcExIdeaType类型表示附加创意。在新增附加创意前，需要创建CpcExIdeaType类型的对象，并设置该对象必须的属性。 ( 详情请见下面的 API 参考 ) 构造完成合适的 CpcExIdeaType 对象后，即可调用addExtraIdea() 方法添加该附加创意到指定的推广组中。添加成功后，您可以获得新增附加创意的 id ，此 id 全局唯一。您可以根据此 id 对附加创意进行更新 / 删除操作。该接口支持批量增加附加创意，您可在一次请求中批量添加多个附加创意。
请求方式：
POST（HTTPS）
请求地址：
SERVER_HOST/api/v2/cpcextraidea/addExtraIdea
请求参数体：
{
"body": {//
"extraIdeas": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果：
{
"data": [//
{
"cpcExtraIdeaId": 0,//
"subChainCheckStatus": 0,//
"picModiCheckStatus": 0,//
"subChainModiCheckStatus": 0,//
"opt": {},//
"cpcGrpId": 0,//
"pause": false,//
"cpcExtraIdeaDeviceType": 0,//
"exIdeaSubChains": [//
{
"exIdeaSubChainId": 0,//
"cpcExtraIdeaId": 0,//
"name": "",//
"url": "",//
"rank": 0//
}
],
"exIdeaPic": {//
"exIdeaPicId": 0,//
"cpcExtraIdeaId": 0,//
"picUploadUrl": "",//
"picVisitUrl": "",//
"picBytes": []//
},
"picCheckStatus": 0//
}
],
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
|