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

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