標準錯誤回應

本文件說明 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]"
 }
}

錯誤

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-Match` 或 `If-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-Match` 或 `If-None-Match` 標頭，才能成功處理。

TOO_MANY_REQUESTS (429)

錯誤代碼	說明
`rateLimitExceeded`	在特定時間內傳送太多要求。

INTERNAL_SERVER_ERROR (500)

錯誤代碼	說明
`internalError`	發生內部錯誤，因此要求失敗。

NOT_IMPLEMENTED (501)

錯誤代碼	說明
`notImplemented`	未執行要求的作業。
`unsupportedMethod`	要求嘗試執行不明方法或作業，因此無法處理。

SERVICE_UNAVAILABLE (503)

錯誤代碼	說明
`backendError`	發生後端錯誤。
`backendNotConnected`	發生連線錯誤，導致要求失敗。
`notReady`	API 伺服器目前無法接受要求。