调用Bing Ads Reporting API遇反序列化失败及令牌刷新异常问题

1. OAuth令牌刷新异常解决 #

• 检查授权请求的权限配置：授权scope必须包含offline_access，这是获取可长期使用的刷新令牌的必要参数，缺这个参数就算接口返回了refresh_token，后续刷新时也会直接返回未认证错误，必须重复请求用户授权。
• 核对刷新令牌的请求格式：刷新请求必须用POST方法，Content-Type设为application/x-www-form-urlencoded，参数需包含：
  • grant_type=refresh_token
  • client_id：应用注册时拿到的客户端ID
  • client_secret：Web应用对应的客户端密钥
  • refresh_token：上一次授权/刷新成功拿到的最新refresh_token
  • redirect_uri：必须和用户授权时填写的回调地址完全一致，末尾斜杠、http/https协议差异都会导致校验失败
• 注意刷新令牌的使用规则：Bing Ads的refresh_token是一次性的，每次刷新成功后旧的refresh_token会立即失效，必须持久化存储每次接口返回的新refresh_token，不要重复使用同一个旧令牌调用刷新接口。
• 检查应用注册类型：Postman、Mulesoft这类服务端调用场景，必须把应用注册为Web平台类型，单页应用、原生移动端应用的refresh_token会有额外的客户端校验规则，很容易出现刷新失败问题。
• 有效期说明：正常使用的refresh_token有效期为90天，每次调用刷新接口会自动续期，如果连续90天没有调用接口，refresh_token会自动过期，此时需要重新走一次用户授权流程。

2. SOAP反序列化报错解决 #

这个报错的核心原因不是报表类型不支持，也不是参数不全，是你的SOAP请求里类型声明的命名空间缺失，加上SOAPAction头配置错误导致的，按以下步骤修正即可：

• 修正i:type属性的命名空间：你当前写的i:type="AccountPerformanceReportRequest"没有绑定正确的v13命名空间，服务端无法识别该类型对应的契约，改成i:type="v:AccountPerformanceReportRequest"即可，因为你已经在Envelope节点把https://bingads.microsoft.com/Reporting/v13绑定到了v前缀，加前缀后服务端可以正确映射类型。
• 补全SOAPAction请求头：不要只填SubmitGenerateReport，必须填完整值"https://bingads.microsoft.com/Reporting/v13/SubmitGenerateReport"，WCF服务对SOAPAction的命名空间校验严格，短格式的Action头会导致请求被路由到错误的处理逻辑，触发反序列化错误。
• 补全请求的必填节点：类型识别问题解决后，还需要补全三个必填节点，否则会报参数校验错误：
  • <v:Scope>：指定要查询的广告账户ID列表
  • <v:Time>：指定报表统计的时间范围，支持自定义日期区间或预设时间（如昨天、过去7天）
  • <v:Columns>：指定需要拉取的报表字段，比如点击量、消耗、展示量等
• 修正后的核心请求片段参考：

<v:SubmitGenerateReportRequest>
    <v:ReportRequest i:type="v:AccountPerformanceReportRequest">
        <v:Format>Csv</v:Format>
        <v:ReportName>AccountPerfReport</v:ReportName>
        <v:Aggregation>Summary</v:Aggregation>
        <!-- 账户作用域 -->
        <v:Scope>
            <v:AccountIds>
                <v:long>替换为你的广告账户ID</v:long>
            </v:AccountIds>
        </v:Scope>
        <!-- 时间范围，示例取前一天数据 -->
        <v:Time>
            <v:PredefinedTime>Yesterday</v:PredefinedTime>
        </v:Time>
        <!-- 要拉取的字段 -->
        <v:Columns>
            <v:AccountPerformanceReportColumn>TimePeriod</v:AccountPerformanceReportColumn>
            <v:AccountPerformanceReportColumn>Clicks</v:AccountPerformanceReportColumn>
            <v:AccountPerformanceReportColumn>Spend</v:AccountPerformanceReportColumn>
            <v:AccountPerformanceReportColumn>Impressions</v:AccountPerformanceReportColumn>
        </v:Columns>
    </v:ReportRequest>
</v:SubmitGenerateReportRequest>

按以上配置修改后，就可以正常拿到报表请求ID，后续轮询PollGenerateReport接口时也需要注意同样的命名空间和SOAPAction规则。

内容的提问来源于stack exchange，提问作者joono