|
创意服务 | 创意服务(Restful)
获取账户信息
注:此方法在更新的时候是一个整体,所有属性必须全部填写,如果某一属性不想更新,需将其原貌输入。
方法说明:通过 updateCpcIdea() 方法,您可以更新创意的属性。在更新之前需要创建 CpcIdeaType 类型的对象,设定该对象的 cpcIdeaId 值和其它所需要更新的属性,设置完成后即可调用 updateCpcIdea() 进行创意属性的更新。
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/updateCpcIdea
请求参数体:
{
"body": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcIdeaIdByCpcGrpId
根据指定的推广组 id 获取创意 id
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/getCpcIdeaIdByCpcGrpId
请求参数体:
{
"body": {//
"cpcGrpIds": [],//
"getTemp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"cpcGrpIdeaIds": [//
{
"cpcGrpId": 0,//
"cpcIdeaIds": []//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcIdeaByCpcGrpId
根据指定的推广组 id 获取创意 ( 推广组 id 可批量 )。
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/getCpcIdeaByCpcGrpId
请求参数体:
{
"body": {//
"cpcGrpIds": [],//
"getTemp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
getCpcIdeaByCpcIdeaId
根据指定的创意 id 获取创意。
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/getCpcIdeaByCpcIdeaId
请求参数体:
{
"body": {//
"cpcIdeaIds": [],//
"getTemp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
deleteCpcIdea
通过 deleteCpcIdea() 方法,以创意 id 为参数,您可以删除指定的一个或多个创意。
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/deleteCpcIdea
请求参数体:
{
"body": {//
"cpcIdeaIds": [],//
"temp": 0//
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"response": ""//
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
addCpcIdea
通过 addCpcIdea() 方法,您可以在您的推广组下增加创意。创意使用 CpcIdeaType 类型表示。在新增创意前,您首先需要创建 CpcIdeaType 类型的对象,并设置该对象必须的属性。 ( 详情请见下面的 API 参考 ) 构造完成合适的 CpcIdeaType 对象后,即可调用 addCpcIdea() 方法添加该创意到指定的推广组中。添加成功后,您可以获得新增创意的 id ,此 id 全局唯一。您可以根据此 id 对创意进行更新 / 删除操作。该接口支持批量增加创意,您可在一次请求中批量添加多个创意。
请求方式:
POST(HTTPS)
请求地址:
SERVER_HOST/api/v2/cpcidea/addCpcIdea
请求参数体:
{
"body": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"header": {
"adType": 1,
"agentpassword": "",
"agentusername": "",
"apiusertype": "",
"password": "xxxxxx",
"token": "xxxxxxx",
"username": "xxxxxx"
}
}
|
响应结果:
{
"data": {//
"cpcIdeaTypes": [//
{
"cpcIdeaId": 0,//
"mobileVisitUrl": "",//
"mobileShowUrl": "",//
"opt": [],//
"cpcGrpId": 0,//
"title": "",//
"description1": "",//
"description2": "",//
"visitUrl": "",//
"showUrl": "",//
"pause": false,//
"status": 0//
}
]
},
"desc": "success",
"failures": [],
"oprs": 1,
"oprtime": 1,
"quota": 1,
"rquota": 100,
"status": 0
}
|
|