Google自定义搜索API持续返回‘无效参数’错误求助

问题根源：缺少必填的cx参数 #

Google自定义搜索API v1强制要求请求携带自定义搜索引擎ID（即cx参数），只传q和key的请求是不合法的——哪怕用官方的"Try it out"工具，没填cx也会报这个错。

解决步骤 #

1. 获取cx值 #

前往Google自定义搜索控制台创建一个自定义搜索引擎：

• 可设置为搜索整个全网（在设置选项中选择“搜索整个网络”），无需限定特定站点。
• 创建完成后，在控制台“基本信息”页面找到“搜索引擎ID”，这就是需要的cx参数值。

2. 修正请求URL #

将cx参数添加到请求中，示例格式如下：

https://customsearch.googleapis.com/customsearch/v1?q=test&key=[你的API密钥]&cx=[你的搜索引擎ID]

3. 确认API服务已启用 #

登录Google Cloud控制台，检查API密钥所属项目是否已启用Custom Search API：

• 进入API库，搜索"Custom Search API"，确保服务状态为“已启用”。

4. 检查搜索引擎状态 #

确认你创建的自定义搜索引擎未被暂停，也没有设置异常的访问限制规则。

其他排查方向 #

如果添加cx参数后仍报错，可检查以下内容：

• 核对cx值是否输入正确，排查拼写或复制遗漏问题。
• 查看Google Cloud项目的API调用配额是否耗尽（免费版每天限100次查询）。

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