錯誤訊息

本文件說明 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. 永久移動 (301)
  2. 另行查詢 (303)
  3. 未修改 (304)
  4. 暫時重新導向 (307)
  5. 錯誤的要求 (400)
  6. 未經授權 (401)
  7. 需要付款 (402)
  8. 已禁止 (403)
  9. 找不到 (404)
  10. 不允許的方法 (405)
  11. 衝突 (409)
  12. 消失 (410)
  13. 先決條件失敗 (412)
  14. 要求實體過大 (413)
  15. 要求的範圍不符合規範 (416)
  16. 預期失敗 (417)
  17. 需要先決條件 (428)
  18. 要求數量過多 (429)
  19. 內部伺服器錯誤 (500)
  20. 未執行 (501)
  21. 無法提供服務 (503)

MOVED_PERMANENTLY (301)

錯誤代碼 說明
movedPermanently 本要求及相同作業的後續要求必須傳送到此回應 Location 標頭中指定的 URL,而非先前傳送此回應的目的地 URL。

SEE_OTHER (303)

錯誤代碼 說明
seeOther 已成功處理您的要求。如要取得回應,請將 GET 要求傳送至 Location 標頭中指定的 URL。
mediaDownloadRedirect 已成功處理您的要求。如要取得回應,請將 GET 要求傳送至 Location 標頭中指定的 URL。

NOT_MODIFIED (304)

錯誤代碼 說明
notModified 不符合 If-None-Match 標頭所設定的條件。此回應表示所要求的文件尚未修改,且應當擷取快取的回應。請檢查 If-None-Match HTTP 要求的標頭值。

TEMPORARY_REDIRECT (307)

錯誤代碼 說明
temporaryRedirect 需重新將要求傳送到此回應標頭 Location 中指定的 URL,才能處理您的要求。

BAD_REQUEST (400)

錯誤代碼 說明
badRequest API 要求無效或格式不正確,因此 API 伺服器無法理解該要求。
badBinaryDomainRequest 二進位網域要求無效。
badContent 不支援要求資料的內容類型或多部分要求中某部分的內容類型。
badLockedDomainRequest 鎖定的網域要求無效。
corsRequestWithXOrigin CORS 要求包含 XD3 X-Origin 標頭,表示有錯誤的 CORS 要求在。
endpointConstraintMismatch 要求失敗,原因是不符合指定的 API。請檢查 URL 路徑值,確定路徑正確。
invalid 要求失敗,原因是有無效值。該值可能是參數值、標頭值或屬性值。
invalidAltValue alt 參數值指定了不名的輸出格式。
invalidHeader 要求失敗,原因是有無效標頭。
invalidParameter 要求失敗,原因是有無效參數或參數值。請查閱該 API 說明文件,以確認要求所適用的參數。
invalidQuery 要求無效。請查閱 API 說明文件,確認支援該要求的參數,以及要求是否包含無效的參數組合或無效參數值。請檢查 q 要求的參數值。
keyExpired 要求所提供的 API 金鑰已過期,表示 API 伺服器無法檢查提出要求的應用程式的配額限制。請查閱 Google Developers Console 瞭解詳情,或取得新的金鑰。
keyInvalid 要求所提供的 API 金鑰無效,表示 API 伺服器無法檢查提出要求的應用程式的配額限制。請使用 Google Developers Console 找出您的金鑰,或取得新金鑰。
lockedDomainCreationFailure 查詢字串收到禁用的 OAuth 憑證,此 API 只允許 JSON 或 XML 回應格式。請盡量改用 Authorization 標頭傳送 OAuth 憑證。
notDownload 只有媒體下載要求可以傳送至 /download/* URL 路徑。請重新傳送要求至相同路徑,但去除 /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 Developer Console (https://developers.google.com/console) 建立您的應用程式專案。
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 伺服器目前無法接受要求。
本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Billing 說明文件
需要協助嗎?請前往我們的支援網頁