本頁面由 Cloud Translation API 翻譯而成。

核心錯誤

本文件說明 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 回應格式。請盡量改為傳送 OAuth 權杖在 Authorization 標頭中。
`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 伺服器目前無法接受要求。