自动提交网址或读取Bing报告的脚本若仍使用SOAP、POX,需要迁移。Bing Webmaster已在2026年8月31日停用这两种方式;改成REST/JSON时,请求、返回数据的解析和定时任务入口要一起改。
对运营来说,常见现象是自动提交失败,或报表突然空白。对开发来说,不能只替换一个网址:旧脚本读XML,新接口回JSON,即使请求成功,旧解析程序也可能取不到数字。 接口恢复后仍要确认网址实际经历了什么;可参考发现、抓取与索引的排查顺序组织记录,其中Google和Bing的数据入口须分别使用。
先改一项只读统计:请求与返回结构一起迁
以GetRankAndTrafficStats为例。下面的域名和API Key都是占位,展示同一统计任务的请求迁移;没有访问真实账户。旧POX调用路径形如:
GET https://ssl.bing.com/webmaster/api.svc/pox/GetRankAndTrafficStats?siteUrl=https%3A%2F%2Fexample.com%2F&apikey=YOUR_API_KEY
迁到官方JSON入口时,同一只读方法使用GET,站点参数仍做URL编码:
GET https://ssl.bing.com/webmaster/api.svc/json/GetRankAndTrafficStats?siteUrl=https%3A%2F%2Fexample.com%2F&apikey=YOUR_API_KEY
逐项核对方法、HTTP动作与参数,不能把所有旧SOAP操作都当成GET。旧SOAP调用可能使用XML信封(Envelope)与代理对象;迁移时按对应JSON方法重新构造,不只是全局替换字符串。微软统计方法文档
旧XML节点怎样变成JSON记录
例如旧解析器在XML里找Clicks节点,新结果的精简教学形式是:
{"d":[{"Clicks":15,"Impressions":100,"Date":"/Date(1316156400000-0700)/"}]}
实际记录在d数组中。Clicks和Impressions是计数,Date是微软日期表示;开头数字是Unix毫秒,后面的偏移不是应再加减一次的毫秒。下面把日期转成明确UTC,再交给报表做目标时区显示:
import re
from datetime import datetime, timezone
def traffic_rows(payload):
rows = payload.get("d")
if not isinstance(rows, list):
raise ValueError("统计响应缺少d数组,不能填成零流量")
result = []
for row in rows:
match = re.fullmatch(r"/Date\((-?\d+)(?:[+-]\d{4})?\)/", row["Date"])
if not match:
raise ValueError("需核对实际日期格式")
date = datetime.fromtimestamp(int(match[1]) / 1000, tz=timezone.utc)
result.append({"date_utc": date.isoformat(),
"clicks": row["Clicks"], "impressions": row["Impressions"]})
return result
用上面的教学JSON,可读出15次点击、100次展示及UTC时间。实际调用时,先核对HTTP状态与JSON结构;401/403、HTML错误页或缺字段不能转成d:[]。合法空数组可以表示这次统计没有记录,仍需保留请求站点与范围,不擅自填成网站所有流量为零。
提交网址是另一种返回,不能复用统计解析
SubmitUrl用于写入提交,官方JSON样例使用POST,参数在JSON正文:
POST https://ssl.bing.com/webmaster/api.svc/json/SubmitUrl?apikey=YOUR_API_KEY
Content-Type: application/json; charset=utf-8
{"siteUrl":"https://example.com/","url":"https://example.com/products/lamp/"}
成功响应示例是{"d":null}。它与统计方法的d数组不同,不应该送进上面的traffic_rows函数。这里没有曝光点击可取,也不能把null解释成零流量、失败或已经收录。
真实切换时,先按原授权方式及当前额度核只读调用,再由有权限的维护者受控提交一条实际页面,保留状态和返回。本文的请求只作写法教学,没有提交这些示例地址,也没有操作用户Bing账户。

切换原任务入口:范围、授权与失败必须保留
Microsoft的当前API首页已列明SOAP、POX退役和REST迁移要求。范围是Bing Webmaster Tools,不能推广成Bing Ads或所有SOAP接口都停用。
让维护者找自动提交URL、拉取曝光点击、生成报表的实际脚本,再核计划任务运行哪份文件。搜索soap、pox和XML解析是线索;判断仍以当前调用路径及日志为准。
SOAP与POX都使用XML格式。JSON则是另一种数据格式,字段和外层结构不同。路径中还带api.svc,不代表仍是SOAP:官方JSON示例本身就用api.svc/json。

保留已有授权方式,切换原计划任务
Bing支持OAuth与API Key,请求形式按对应官方指南维护,不把两种认证混成一份请求,也不在日志或工单公开凭据。
手动跑通的新文件,如果定时任务仍指向旧文件,第二天仍会失败。维护者应核任务入口、运行账号与输出位置;让新报告进入原来使用它的报表或告警流程,确认下游报表或告警能继续读取新数据。
保留一条当前成功记录和明确失败报警。只读统计正常、受控提交正常、计划任务使用新入口,才算这条调用链完成迁移。若还有空报表,继续找哪一步缺记录,不把所有空值填成零。
要从整体SEO工作判断这个故障的优先级,可以回到Google SEO学习路径了解监测与内容工作的关系;需要梳理站长工具接入,可向跨境YOUNG提供脱敏调用路径、报错和期望的报告字段。
继续阅读:谷歌SEO完整优化流程:继续了解抓取、索引和页面维护的完整步骤。
常见问题
URL带api.svc,说明还在用SOAP吗?
不能。官方JSON样例也使用api.svc/json,应核后面的协议路径、请求格式和实际调用。
换成JSON后返回200,算完成了吗?
还要确认数据被正确解析,并进入原报告;写接口也要按自己的返回结构检查。定时任务必须运行新入口。
SubmitUrl成功,就代表Bing已经收录吗?
不代表。提交与后续抓取、索引是不同阶段,接口返回只能用于检查本次提交。



