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

WebService介绍  |  请求头信息

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

元素名 含义 是否必填
agentusername 代理商账户/账户管家帐户名称 代理商账户/账户管家账户登录时必填
agentpassword 代理商账户/账户管家帐户密码 代理商账户/账户管家账户登录时必填
username 账户名称,代理商/账户管家登录时为被代管的账户 必填
password 账户密码 代理商账户/账户管家账户登录时非必填
token 账户token值 必填
adType 平台类型,区分操作物料平台
1:网页搜索推广
2:搜索内容生态推广
3:信息流推广
选填,默认是1
apiusertype 账户类型 通过账户管家账户登录时必填,需要取值为manageapi
软件厂商登录时必填,取值为soft

如果您是代理商,想操作您下面的用户,则您需要填入 agentusername、agentpassword、username、token这4 个属性;如果您是普通用户,您只需填入 username 、 password 、及 token 这 3 个属性。
您需要将上述信息放到一个 AuthHeader 对象中,然后把该 AuthHeader 对象置于 SOAP 的请求头信息( SOAP Header )中,如下文的示例所示。 AuthHeader 中包含了四个元素,分别是代理商帐户名、代理商密码、用户名和 token 值。
下面是一个查询推广组信息的请求

<soapenv:Envelope xmlns:soapenv=" http://schemas.xmlsoap.org/soap/envelope/ "
xmlns:v1=" http://api.sogou.com/sem/common/v1 "
xmlns:v11=" https://api.sogou.com/sem/sms/v1 ">
<soapenv:Header>
<v1:AuthHeader>
<v1:agentusername> </v1:agentusername>
<v1:agentpassword> </v1:agentpassword>
<v1:username> </v1:username>
<v1:token> </v1:token>
</v1:AuthHeader>
</soapenv:Header>
<soapenv:Body>
<v11:getCpcGrpByCpcGrpIdRequest>
<cpcGrpIds>22993325</cpcGrpIds>
<cpcGrpIds>22893327</cpcGrpIds>
<cpcGrpIds>22993327</cpcGrpIds>
<cpcGrpIds>22893329</cpcGrpIds>
<cpcGrpIds>22993329</cpcGrpIds>
<cpcGrpIds>22893331</cpcGrpIds>
<cpcGrpIds>22993331</cpcGrpIds>
</v11:getCpcGrpByCpcGrpIdRequest>
</soapenv:Body>
</soapenv:Envelope>