错误消息

本文档介绍了 Google API 返回的一些错误代码和消息。具体而言,此处列出的错误可能存在于 Google API 的全局网域中,也可能存在于默认网域中。许多 API 还会定义自己的网域,可识别出全局网域以外特定于 API 的错误。对于这些错误,JSON 响应中 domain 属性的值将会是一个特定于 API 的值,例如 youtube.parameter

此页面根据 RFC 7231 中定义的 HTTP 状态代码列出了相关错误。

以下示例 JSON 响应展现了全局错误是如何传达的:

{
 "error": {
  "errors": [
   {
    "domain": "global",
    "reason": "invalidParameter",
    "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
    "locationType": "parameter",
    "location": "chart"
   }
  ],
  "code": 400,
  "message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
 }
}

错误

  1. MOVED_PERMANENTLY (301)
  2. SEE_OTHER (303)
  3. NOT_MODIFIED (304)
  4. TEMPORARY_REDIRECT (307)
  5. BAD_REQUEST (400)
  6. UNAUTHORIZED (401)
  7. PAYMENT_REQUIRED (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_ALLOWED (405)
  11. CONFLICT (409)
  12. GONE (410)
  13. PRECONDITION_FAILED (412)
  14. REQUEST_ENTITY_TOO_LARGE (413)
  15. REQUESTED_RANGE_NOT_SATISFIABLE (416)
  16. EXPECTATION_FAILED (417)
  17. PRECONDITION_REQUIRED (428)
  18. TOO_MANY_REQUESTS (429)
  19. INTERNAL_SERVER_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

错误代码 说明
movedPermanently 该请求及以后针对同一操作的请求必须发送到在此响应的 Location 标头中指定的网址,而不是该请求已发送到的网址。

SEE_OTHER (303)

错误代码 说明
seeOther 您的请求已成功处理。要获得您的响应,请向 Location 标头中指定的网址发送 GET 请求。
mediaDownloadRedirect 您的请求已成功处理。要获得您的响应,请向 Location 标头中指定的网址发送 GET 请求。

NOT_MODIFIED (304)

错误代码 说明
notModified 不符合为 If-None-Match 标头设置的条件。此响应指出所请求的文档尚未修改,应当检索缓存的响应。查看 If-None-Match HTTP 请求标头的值。

TEMPORARY_REDIRECT (307)

错误代码 说明
temporaryRedirect 要使您的请求得到处理,请将其重新发送到此响应的 Location 标头中指定的网址。

BAD_REQUEST (400)

错误代码 说明
badRequest 该 API 请求无效或格式不正确。因此,API 服务器无法解读该请求。
badBinaryDomainRequest 该二进制网域请求无效。
badContent 请求数据的内容类型或多部分请求中某一部分的内容类型不受支持。
badLockedDomainRequest 锁定的网域请求无效。
corsRequestWithXOrigin 该 CORS 请求包含 XD3 跨源标头,表明这是一个错误的 CORS 请求。
endpointConstraintMismatch 由于与指定的 API 不符,系统无法完成该请求。请查看网址路径的值,以确保其正确无误。
invalid 由于包含无效值,系统无法完成该请求。该值可能是参数值、标头值或属性值。
invalidAltValue alt 参数值指定了一个未知输出格式。
invalidHeader 由于包含无效标头,系统无法完成该请求。
invalidParameter 由于包含无效参数或参数值,系统无法完成该请求。请查看 API 文档,以确定哪些参数对您的请求有效。
invalidQuery 该请求无效。请查看 API 文档,以确定该请求支持哪些参数,同时查看该请求是否包含无效的参数组合或无效的参数值。请查看 q 请求参数的值。
keyExpired 该请求中提供的 API 密钥已过期,这表示 API 服务器无法查看发出该请求的应用的配额限制。请查看 Google Developers Console 了解详情或获取新密钥。
keyInvalid 该请求中提供的 API 密钥无效,这表示 API 服务器无法查看发出该请求的应用的配额限制。请使用 Google Developers Console 查找您的 API 密钥或再获取一个。
lockedDomainCreationFailure 该 OAuth 令牌是在查询字符串中收到的,而此 API 禁止对 JSON 或 XML 之外的响应格式使用此方式。如果可能,请尝试将 OAuth 令牌放在授权标头中发送。
notDownload 只有媒体下载请求可发送到 /download/* 网址路径。请向同一个路径重新发送该请求,但要去掉 /download 前缀。
notUpload 由于不是上传请求,所以此请求失败。只有上传请求可发送到 /upload/* URI。请尝试向同一个路径重新发送该请求,但要去掉 /upload 前缀。
parseError API 服务器无法解析请求正文。
required 该 API 请求缺少必需的信息。必需信息可能是参数,也可能是资源属性。
tooManyParts 由于包含的部分过多,系统无法完成该多部分请求。
unknownApi 无法识别该请求调用的 API。
unsupportedMediaProtocol 该客户端使用的媒体协议不受支持。
unsupportedOutputFormat 此服务不支持 alt 参数值指定的输出格式。请查看 alt 请求参数的值。
wrongUrlForUpload 该请求是上传请求,但由于未发送到正确的 URI,系统无法完成这个请求。上传请求必须发送给包含 /upload/* 前缀的 URI。请尝试向同一个路径重新发送该请求,但要包含 /upload 前缀。

UNAUTHORIZED (401)

错误代码 说明
unauthorized 该用户无权发出请求。
authError 针对该请求提供的授权凭据无效。查看 Authorization HTTP 请求标头的值。
expired 会话已过期。查看 Authorization HTTP 请求标头的值。
lockedDomainExpired 由于之前有效的锁定网域已过期,系统无法完成该请求。
required 该用户必须登录才能发出此 API 请求。请查看 Authorization HTTP 请求标头的值。

PAYMENT_REQUIRED (402)

错误代码 说明
dailyLimitExceeded402 已达到开发者设置的每日预算上限。
quotaExceeded402 所请求的操作需要的资源超出配额允许的上限。需要付款才能完成该操作。
user402 所请求的操作需要已通过身份验证的用户来完成某种付款。

FORBIDDEN (403)

错误代码 说明
forbidden 所请求的操作已被禁止,无法完成。
accessNotConfigured 您的项目未配置为有权访问此 API。请使用 Google Developers Console 为您的项目激活此 API。
accessNotConfigured 该项目由于存在滥用行为而被阻止。请参阅 http://support.google.com/code/go/developer_compliance
accessNotConfigured 该项目已被标记为删除。
accountDeleted 与该请求的授权凭据相关联的用户账号已被删除。查看 Authorization HTTP 请求标头的值。
accountDisabled 与该请求的授权凭据相关联的用户账号已被停用。查看 Authorization HTTP 请求标头的值。
accountUnverified 发出该请求的用户的电子邮件地址尚未进行验证。查看 Authorization HTTP 请求标头的值。
concurrentLimitExceeded 由于已达到并发使用上限,系统无法完成该请求。
dailyLimitExceeded 已达到该 API 的每日配额上限。
dailyLimitExceeded 已达到每日配额上限,并且该项目由于存在滥用行为已被阻止。请参阅 Google API 合规性支持表单,获取解决该问题的相关帮助。
dailyLimitExceededUnreg 由于已达到未经身份验证的 API 的每日使用上限,系统无法完成该请求。若要继续使用该 API,则需要通过 Google Developers Console 进行注册。
downloadServiceForbidden 该 API 不支持下载服务。
insufficientAudience 无法对此受众群体完成该请求。
insufficientAuthorizedParty 无法对此应用完成该请求。
insufficientPermissions 该通过身份验证的用户权限不足,无法执行此请求。
limitExceeded 由于访问权限或速率限制,系统无法完成该请求。
lockedDomainForbidden 此 API 不支持锁定的网域。
quotaExceeded 所请求的操作需要的资源超出配额允许的上限。
rateLimitExceeded 在指定时间范围内发送的请求过多。
rateLimitExceededUnreg 已超出速率限制,您必须注册自己的应用才能继续调用该 API。请使用 Google Developers Console 注册。
responseTooLarge 请求的资源过大,无法返回。
servingLimitExceeded 已达到为该 API 指定的整体速率上限。
sslRequired 需要使用 SSL 才能执行此操作。
unknownAuth API 服务器未识别出用于该请求的授权方案。请查看 Authorization HTTP 请求标头的值。
userRateLimitExceeded 由于已达到每个用户的速率上限,系统无法完成该请求。
userRateLimitExceededUnreg 由于已达到每个用户的速率上限,系统无法完成该请求,并且在请求中未识别出客户端开发者。请使用 Google Developers Console (https://console.developers.google.com) 为您的应用创建一个项目。
variableTermExpiredDailyExceeded 由于不定期限配额已过期并且已达到每日上限,系统无法完成该请求。
variableTermLimitExceeded 由于已达到不定期限配额上限,系统无法完成该请求。

NOT_FOUND (404)

错误代码 说明
notFound 由于找不到与该请求关联的资源,系统无法完成所请求的操作。
notFound 找不到与该请求关联的资源。如果您在过去两周内未用过此 API,请重新部署 App Engine 应用,然后再次尝试调用此 API。
unsupportedProtocol 该请求中使用的协议不受支持。

METHOD_NOT_ALLOWED (405)

错误代码 说明
httpMethodNotAllowed 与该请求关联的 HTTP 方法不受支持。

CONFLICT (409)

错误代码 说明
conflict 由于请求的操作会与现有项目产生冲突,系统无法完成该 API 请求。例如,尽管在重复项中通常会识别出更具体的错误,但尝试创建重复项的请求将会产生冲突。
duplicate 由于所请求的操作尝试创建已存在的资源,系统无法完成该请求。

GONE (410)

错误代码 说明
deleted 由于与该请求关联的资源已被删除,系统无法完成该请求。

PRECONDITION_FAILED (412)

错误代码 说明
conditionNotMet 不符合在该请求的 If-MatchIf-None-Match HTTP 请求标头中设置的条件。请参阅 HTTP 规范的 ETag 部分了解详情,查看 If-Match HTTP 请求标头的值。

REQUEST_ENTITY_TOO_LARGE (413)

错误代码 说明
backendRequestTooLarge 该请求太大。
batchSizeTooLarge 该批量请求中包含的元素过多。
uploadTooLarge 由于在该请求中发送的数据过大,系统无法完成该请求。

REQUESTED_RANGE_NOT_SATISFIABLE (416)

错误代码 说明
requestedRangeNotSatisfiable 无法满足该请求指定的范围。

EXPECTATION_FAILED (417)

错误代码 说明
expectationFailed 服务器无法实现客户端预期目标。

PRECONDITION_REQUIRED (428)

错误代码 说明
preconditionRequired 未提供该请求需要的先决条件。要成功完成该请求,您需要在请求中提供 If-MatchIf-None-Match 标头。

TOO_MANY_REQUESTS (429)

错误代码 说明
rateLimitExceeded 在指定时间范围内发送的请求过多。

INTERNAL_SERVER_ERROR (500)

错误代码 说明
internalError 由于内部错误,系统无法完成该请求。

NOT_IMPLEMENTED (501)

错误代码 说明
notImplemented 请求的操作尚未实现。
unsupportedMethod 由于该请求尝试执行未知方法或操作,系统无法完成该请求。

SERVICE_UNAVAILABLE (503)

错误代码 说明
backendError 发生后端错误。
backendNotConnected 由于连接错误,系统无法完成该请求。
notReady API 服务器尚未准备好接受请求。