谷歌索引API错误码详解及常见问题修复方法

谷歌索引API错误详解

当谷歌索引API返回特定错误代码时，意味着相关请求已被拒绝，且谷歌将不会抓取指定的网址。本指南详细介绍了谷歌API可能返回的错误代码及对应说明，重点聚焦于全局网域（默认网域）中的错误情况。需要注意的是，部分API会设置独立网域，用于标识仅在该API范围内生效的错误。此类错误在JSON响应中的domain属性会显示为API专属域名，例如youtube.parameter。

以下是按照RFC 7231标准定义的HTTP状态代码错误分类：

API通用错误代码解析

301 MOVED_PERMANENTLY
说明：此响应指示后续所有相关请求需发送至Location头标中指定的URL，而非原始请求地址。

303 SEE_OTHER
说明：请求已成功处理，但获取完整响应需向Location头标指定URL发起GET请求。

mediaDownloadRedirect：同303，表示请求已成功处理，需向指定URL发送GET请求。

304 NOT_MODIFIED
说明：响应表明请求资源未发生变更，应使用缓存版本。需检查If-None-Match头标设置值。

307 TEMPORARY_REDIRECT
说明：请求需重定向至Location头标指定的URL以完成处理。

400 BAD_REQUEST
常见错误类型：
– badRequest：API请求无效或格式错误，服务器无法解析。
– badBinaryDomainRequest：二进制网域请求无效。
– badContent：请求数据内容类型或 multipart 请求部分类型不受支持。
– badLockedDomainRequest：锁定网域请求无效。
– corsRequestWithXOrigin：包含XD3跨域标头的CORS请求错误。
– endpointConstraintMismatch：请求路径与指定API不符。
– invalid：参数值、头标值或属性值包含无效数据。
– invalidAltValue：alt参数指定了未知输出格式。
– invalidHeader：请求包含无效头标。
– invalidParameter：参数无效或参数值错误，建议查阅API文档确认。
– invalidQuery：请求无效，可能包含无效参数组合或值，需检查q参数。
– keyExpired：API密钥过期，服务器无法获取应用配额限制。
– keyInvalid：API密钥无效，服务器无法获取应用配额限制。
– lockedDomainCreationFailure：OAuth令牌通过查询字符串传递，而该API禁止对JSON/XML格式使用查询字符串。
– notDownload：媒体下载请求必须发送至/download/*路径。
– notUpload：非上传请求，上传请求需发送至/upload/* URI。
– parseError：API服务器无法解析请求正文。
– required：请求缺少必要信息，可能是参数或资源属性。
– tooManyParts：multipart请求包含过多部分。
– unknownApi：系统无法识别请求调用的API。
– unsupportedMediaProtocol：客户端使用的媒体协议不受支持。
– unsupportedOutputFormat：服务不支持alt参数指定的输出格式。
– wrongUrlForUpload：上传请求未发送至正确URI，需包含/upload前缀。

401 UNAUTHORIZED
常见错误类型：
– unauthorized：用户无权发起请求。
– authError：提供的授权凭据无效。
– expired：会话超时。
– lockedDomainExpired：先前有效的锁定网域过期。
– required：用户需登录才能发起API请求。

402 PAYMENT_REQUIRED
常见错误类型：
– dailyLimitExceeded402：超出开发者设置的每日预算上限。
– quotaExceeded402：请求资源超出配额上限，需付费完成。
– user402：请求操作需要已认证用户完成付款。

403 FORBIDDEN
常见错误类型：
– forbidden：请求操作被禁止。
– accessNotConfigured：项目未配置API访问权限。
– accessNotConfigured：项目因滥用行为被阻止。
– accessNotConfigured：项目被标记为待删除。
– accountDeleted：关联用户账号被删除。
– accountDisabled：关联用户账号被停用。
– accountUnverified：用户邮箱未验证。
– concurrentLimitExceeded：达到并发使用上限。
– dailyLimitExceeded：达到每日配额上限。
– dailyLimitExceeded：每日配额超限且项目被阻止。
– dailyLimitExceededUnreg：未经认证时达到每日使用上限。
– downloadServiceForbidden：该API不支持下载服务。
– insufficientAudience：无法对指定受众完成请求。
– insufficientAuthorizedParty：无法对该应用完成请求。
– insufficientPermissions：认证用户权限不足。
– limitExceeded：因访问权限或速率限制无法完成请求。
– lockedDomainForbidden：该API不支持锁定网域。
– quotaExceeded：请求资源超出配额上限。
– rateLimitExceeded：指定时间范围内请求过多。
– rateLimitExceededUnreg：超出速率限制，需注册应用继续使用。
– responseTooLarge：请求资源过大无法返回。
– servingLimitExceeded：达到API整体速率上限。
– sslRequired：操作需使用SSL执行。
– unknownAuth：未识别请求授权方案。
– userRateLimitExceeded：达到每个用户的速率上限。
– userRateLimitExceededUnreg：未标识客户端开发者时达到用户速率上限。

404 NOT_FOUND
常见错误类型：
– notFound：找不到关联资源。
– notFound：两周内未使用API时需重新部署App Engine应用。
– unsupportedProtocol：请求使用的协议不受支持。

405 METHOD_NOT_ALLOWED
说明：请求关联的HTTP方法不被支持。

409 CONFLICT
常见错误类型：
– conflict：请求操作与现有条目冲突，如尝试创建重复条目。
– duplicate：请求操作尝试创建已存在的资源。

410 GONE
说明：关联资源已被删除。

412 PRECONDITION_FAILED
常见错误类型：
– conditionNotMet：If-Match或If-None-Match头标设置条件未满足。

413 REQUEST_ENTITY_TOO_LARGE
常见错误类型：
– backendRequestTooLarge：请求过大。
– batchSizeTooLarge：批量请求包含过多元素。
– uploadTooLarge：请求发送数据过大。

416 REQUESTED_RANGE_NOT_SATISFIABLE
说明：无法满足请求指定的范围。

417 EXPECTATION_FAILED
说明：服务器无法实现客户端预期目标。

428 PRECONDITION_REQUIRED
说明：请求缺少必要先决条件，需提供If-Match或If-None-Match头标。

429 TOO_MANY_REQUESTS
说明：指定时间范围内请求过多。

500 INTERNAL_SERVER_ERROR
说明：因内部错误导致请求失败。

501 NOT_IMPLEMENTED
常见错误类型：
– notImplemented：请求操作尚未实现。
– unsupportedMethod：请求尝试执行未知方法或操作。

503 SERVICE_UNAVAILABLE
常见错误类型：
– backendError：后端错误。
– backendNotConnected：连接错误。
– notReady：API服务器尚未准备好接受请求。

Indexing API专属错误

所有Indexing API错误都会导致请求被拒绝，核心错误消息包括：

400 BAD_REQUEST
错误消息：
– Missing attribute. ‘url’ attribute is required.：用户未设置网址。
– Invalid attribute. ‘url’ is not in standard URL format：网址格式错误，如”abcd”。
– Unknown type. ‘type’ attribute is required and must be ‘URL_REMOVED’ or ‘URL_UPDATED’：未设置通知类型。
– Invalid value at ‘url_notification.type’ (TYPE_ENUM)：通知类型设置错误。

403 FORBIDDEN
错误消息：
– Permission denied. Failed to verify the URL ownership：未完成所有权验证或尝试更新非所属网址。

429 TOO_MANY_REQUESTS
错误消息：
– Insufficient tokens for quota ‘indexing.googleapis.com/default_requests’：超出Indexing API配额。