標準錯誤回應

本文件說明 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 系統已成功處理您的要求。如要取得回應,請將 GET 要求傳送至 Location 標頭中指定的網址。
mediaDownloadRedirect 系統已成功處理您的要求。如要取得回應,請將 GET 要求傳送至 Location 標頭中指定的網址。

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 X-Origin 標頭;這表示有錯誤的 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 回應格式。請儘可能改用 Authorization 標頭傳送 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 應用程式,然後嘗試再次呼叫。
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 伺服器目前無法接受要求。