Google Search Console API请求discover/googleNews报错排查

1. 当前请求的核心配置问题 #

你遇到的INVALID_ARGUMENT错误和站点标识格式（sc-domain前缀、URL编码）没有关系，核心原因是直接复用了web类型的请求参数，没有适配discover、googleNews两个类型的参数限制规则，常见触发场景：

• 传入了目标类型不支持的维度：比如web类型支持的query维度，discover类型完全不支持，只要请求体里带了该维度就会直接返回400
• 传入了目标类型不支持的参数值：比如dataState传ALL、aggregationType传了仅web类型支持的枚举值
• 维度过滤规则包含不支持的维度：比如dimensionFilterGroups里配置了query维度的过滤规则，请求discover时会被判定为参数非法
• 部分场景下时间范围设置超出了目标类型支持的最早数据回溯期，也会触发参数错误

2. 正确配置参数获取两类数据的方法 #

配置时严格按照类型适配参数，不要直接复用web类型的请求模板：

通用前置校验 #

• 先确认使用的是v1版本Search Console API，旧版本API未完整支持discover、googleNews类型
• 测试阶段先将startDate设为最近7天、endDate设为前1天，避免因时间范围超限触发报错，测通后再按需调整时间跨度
• dataState统一设为FINAL，两类数据暂不支持ALL模式
• aggregationType先设为AUTO测通，再根据需求调整为支持的聚合类型

discover类型专属配置 #

• dimensions仅可传入date、page、country、device四个值，禁止传入query、searchAppearance等web类型支持的维度
• dimensionFilterGroups仅可配置上述四个支持维度的过滤规则，移除所有其他维度的过滤配置

googleNews类型专属配置 #

• dimensions支持传入date、page、country、device、query，禁止传入web专属的searchAppearance等不兼容维度
• 过滤规则仅可针对上述支持的维度配置，不要加入web搜索场景专属的过滤条件

3. 获取详细报错信息的方法 #

通用的"Request contains an invalid argument"提示是最外层的通用报错，可通过以下方式拿到字段级的错误原因：

• 解析错误响应体的details字段：Google API的400错误会在该字段下返回具体的非法参数位置、不兼容原因，比如会明确标注不支持的维度名称、非法的参数值，多数场景下可以直接定位问题
• 使用官方API Explorer调试：将你构造的完整请求参数填入官方在线调试工具，提交后会直接返回字段级的校验错误，不需要本地逐行排查参数
• 打印全量请求日志：排查是否有SDK默认注入、你未感知到的冗余参数（比如部分GSC SDK会默认加入query维度），和官方文档的参数支持清单逐一核对

内容的提问来源于stack exchange，提问作者arthur-net