调用Google Indexing API返回403 Forbidden错误问题排查

按以下优先级逐一排查即可解决：

• 首先读取完整响应内容：你当前打印的只是Guzzle响应对象的结构，没有获取响应流里的实际错误信息。响应body是流式资源，直接输出对象不会返回内容，添加以下代码即可拿到Google返回的具体错误码和原因：

// 放在获取$response的代码后
$responseContent = $response->getBody()->getContents();
var_dump($responseContent);

绝大多数无提示403都是因为未读取响应流，实际错误原因（权限不足、域名未校验、配额耗尽等）都存放在响应体中。

• 校验服务账号权限配置：服务账号的所有者权限必须在Google搜索控制台（原站长平台）配置，不是在Google Cloud的IAM页面配置。进入对应域名的「域名级属性」（不要用URL前缀属性），在用户管理中添加服务账号的邮箱为所有者角色，配置后等待15-30分钟待权限同步后再测试，权限同步存在固定延迟，刚配置完立刻测试会返回403。
• 校验请求URL归属：请求的URL必须完全属于你在搜索控制台已验证所有权的域名，注意http/https、www/非www属于不同域名变体，未单独验证的变体发起请求会直接返回403。
• 校验API启用状态：在Google Cloud控制台API库中确认启用的是「Web Search Indexing API」，不要选错成Cloud Search等其他同名索引类API，API启用后等待10分钟以上再发起请求。
• 修正代码请求参数：你当前传参的写法是Guzzle旧版本写法，新版Guzzle传JSON请求体需要指定json字段，自动匹配正确的Content-Type头，避免网关层直接拦截返回403，修改请求代码如下：

$response = $httpClient->post($endpoint, [
    'json' => [
        'url' => 'https://myverifieddomain.com/url',
        'type' => 'URL_UPDATED'
    ]
]);

• 校验配额使用情况：在Google Cloud控制台的配额管理页面，查看Indexing API的当日请求配额是否耗尽，新账号默认每日配额为200次，触发配额上限会直接返回403。

注意：所有配置操作完成后建议等待30分钟再测试，Google侧多服务之间的权限同步延迟最长可达半小时，无需刚配置完就反复调试。

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