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

关键词服务  |  关键词服务(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
}