- 錯誤型別：
- 其他錯誤
- 錯誤名稱：
- 谷歌索引API错误
- 英文名稱：
- Indexing API error
- 錯誤描述：
- API如果返回这些错误，请求都遭到了拒绝，并且 Google 不会抓取相应网址。
本文件介紹了 Google API 返回的一些錯誤程式碼和訊息。具體而言，文中列出的錯誤都是在 Google API 的全域性網域（即預設網域）中發生的。很多 API 還會指定自己的網域，用以標識不在全域性網域中而僅在該 API 範圍內的錯誤。對於這類錯誤，JSON 響應中 domain 屬性的值將會是一個 API 範圍內的值，例如 youtube.parameter。
本頁面根據 RFC 7231 中定義的 HTTP 狀態程式碼列出了這類錯誤。
以下 JSON 響應示例展示了系統如何表述全域性錯誤：
"reason": "invalidParameter",
"message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]",
"locationType": "parameter",
"message": "Invalid string value: 'asdf'. Allowed values: [mostpopular]"
{
"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]"
}
}
{
"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]"
}
}
API 通用錯誤
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 引數值指定了一個未知輸出格式。 |
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-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 伺服器尚未準備好接受請求。 |
Indexing API 相關錯誤
在以下所有情況下，請求都遭到了拒絕，並且 Google 不會抓取相應網址。這也適用於核心錯誤訊息。
BAD_REQUEST (400)
| 錯誤訊息 |
說明 |
Missing attribute. 'url' attribute is required. |
使用者未在其請求中設定網址。 |
Invalid attribute. 'url' is not in standard URL format |
使用者設定的網址看起來不像網址，例如“abcd” |
Unknown type. 'type' attribute is required and must be 'URL_REMOVED' or 'URL_UPDATED'. |
使用者未設定通知型別。 |
Invalid value at 'url_notification.type' (TYPE_ENUM) |
使用者將通知型別設定為 URL_REMOVED 或 URL_UPDATED 以外的其他值。 |
FORBIDDEN (403)
| 錯誤訊息 |
說明 |
Permission denied. Failed to verify the URL ownership. |
使用者未完成所有權驗證流程或正在嘗試更新不歸其所有的網址。 |
TOO_MANY_REQUESTS (429)
| 錯誤訊息 |
說明 |
Insufficient tokens for quota 'indexing.googleapis.com/default_requests' |
使用者已超出其 Indexing API 配額。 |
via 谷歌官方開發文件
評論留言