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

账户服务  |  账户服务(Restful)

获取账户信息

获取 header 中 username 对应的账户信息。
在每次访问 API 时,您需要提供您的 token (权限代码)以及要操作的用户名和密码来进行权限认证。这些数据会通过 HTTPS 加密传输,因此无需担心敏感信息在传输过程中泄漏。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/getAccountInfo

请求参数体:

{
    "body": {},//
    "header": {//
        "adType": 1,//
        "agentpassword": "",//
        "agentusername": "",//
        "apiusertype": "",//
        "password": "",//
        "token": "",//
        "username": ""//
    }
}
									   

响应结果:

{
    "data": {//
        "accountInfoType": {//
            "accountid": 0,//
            "regions": [],//
            "excludeIps": [],//
            "domains": [],//
            "budgetOfflineTime": [//
                {
                    "flag": 0,//
                    "time": ""//
                }
            ],
            "accountLevel": 0,//
            "opt": {},//
            "balance": 0,//
            "totalCost": 0,//
            "totalPay": 0,//
            "budget": 0,//
            "type": 0//
        }
    },
    // 公共响应
}
									   

更新账户信息

更新 header 中 username 对应的账户信息

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/updateAccountInfo

请求参数体:

{
       "body": {//
        "accountInfoType": {//
            "accountid": 0,//
            "regions": [],//
            "excludeIps": [],//
            "domains": [],//
            "budgetOfflineTime": [//
                {
                    "flag": 0,//
                    "time": ""//
                }
            ],
            "accountLevel": 0,//
            "opt": {},//
            "balance": 0,//
            "totalCost": 0,//
            "totalPay": 0,//
            "budget": 0,//
            "type": 0//
        }
    },
    "header": {//
        // 公共的请求header信息
    }
}
									   

响应结果:

{
    "data": [//
        {
            "accountInfoType": {//
                "accountid": 0,//
                "budgetOfflineTime": [//
                    {
                        "flag": 0,//
                        "time": ""//
                    }
                ],
                "accountLevel": 0,//
                "opt": [],//
                "balance": 0,//
                "totalCost": 0,//
                "totalPay": 0,//
                "budget": 0,//
                "type": 0,//
                "regions": [],//
                "excludeIps": [],//
                "domains": []//
            }
        }
    ],
    // 公共响应
}
									   

getChangedId

获取从指定时间到当前时间段内有变化的计划 id 。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/getChangedId

请求参数体:

{
    "body": {//
        "startTime": ""//
    },
    "header": {//
        "adType": 1,//
        "agentpassword": "",//
        "agentusername": "",//
        "apiusertype": "",//
        "password": "",//
        "token": "",//
        "username": ""//
    }
}
									   

响应结果:

{
    "data": {//
        "endTime": "",//
        "changedCpcPlanIds": [//
            {
                "operator": 0,//
                "cpcPlanId": 0//
            }
        ],
        "changedCpcGrpIds": [//
            {
                "operator": 0,//
                "cpcPlanId": 0,//
                "cpcGrpId": 0//
            }
        ],
        "changedCpcIds": [//
            {
                "operator": 0,//
                "cpcId": 0,//
                "cpcPlanId": 0,//
                "cpcGrpId": 0//
            }
        ],
        "changedCpcIdeaIds": [//
            {
                "operator": 0,//
                "cpcIdeaId": 0,//
                "cpcPlanId": 0,//
                "cpcGrpId": 0//
            }
        ]
    },
    // 公共响应
}
									   

getChangedCpcPlanId

获取从指定时间到当前时间段内有变化的计划 id 。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/getChangedCpcPlanId

请求参数体:

{
     "body": {//
        "startTime": "",//
        "cpcPlanLevel": false,//
        "cpcGrpLevel": false,//
        "cpcMaterialLevel": false//
    },
    "header": {//
        "adType": 1,//
        "agentpassword": "",//
        "agentusername": "",//
        "apiusertype": "",//
        "password": "",//
        "token": "",//
        "username": ""//
    }
}
									   

响应结果:

{
   "data": {//
        "endTime": "",//
        "changedCpcPlanIds": [//
            {
                "operator": 0,//
                "cpcPlanId": 0//
            }
        ]
    },
    // 公共响应
}
									   

getChangedCpcMaterialId

获取从指定时间到当前时间段内有变化的物料 ( 关键词、创意 )id 。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/getChangedCpcMaterialId

请求参数体:

{
   "body": {//
        "startTime": "",//
        "levelType": 0,//
        "ids": []//
    },
    "header": {//
        "adType": 1,//
        "agentpassword": "",//
        "agentusername": "",//
        "apiusertype": "",//
        "password": "",//
        "token": "",//
        "username": ""//
    }
}
									   

响应结果:

{
    "data": {//
        "endTime": "",//
        "changedCpcIds": [//
            {
                "operator": 0,//
                "cpcId": 0,//
                "cpcGrpId": 0,//
                "cpcPlanId": 0//
            }
        ],
        "changedCpcIdeaIds": [//
            {
                "operator": 0,//
                "cpcIdeaId": 0,//
                "cpcGrpId": 0,//
                "cpcPlanId": 0//
            }
        ]
    },
    // 公共响应
}
									   

getChangedCpcGrpId

获取从指定时间到当前时间段内有变化的推广组 id 。

请求方式:

POST(HTTPS)

请求地址:

SERVER_HOST/api/v2/account/getChangedCpcGrpId

请求参数体:

{
   "body": {//
        "startTime": "",//
        "cpcPlanIds": [],//
        "cpcGrpLevel": false,//
        "cpcMaterialLevel": false//
    },
    "header": {//
        "adType": 1,//
        "agentpassword": "",//
        "agentusername": "",//
        "apiusertype": "",//
        "password": "",//
        "token": "",//
        "username": ""//
    }
}
									   

响应结果:

{
     "data": {//
        "endTime": "",//
        "changedCpcGrpIds": [//
            {
                "operator": 0,//
                "cpcPlanId": 0,//
                "cpcGrpId": 0//
            }
        ]
    },
    // 公共响应
}