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

创意服务  |  创意服务(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
}