שגיאות ליבה

המסמך הזה מזהה חלק מקודי השגיאה וההודעות ש-Google APIs מחזירים. באופן ספציפי, השגיאות המפורטות כאן הן בדומיין הגלובלי, או בדומיין ברירת המחדל, של ממשקי API של Google. ממשקי API רבים מגדירים גם דומיינים משלהם, שמזהים שגיאות ספציפיות ל-API שאינם בדומיין הגלובלי. עבור השגיאות האלה, הערך של המאפיין domain בתגובת JSON יהיה ערך ספציפי ל-API, כמו youtube.parameter.

דף זה מפרט שגיאות לפי קודי הסטטוס של HTTP, כפי שהוגדרו ב-RFC 7231.

תגובת ה-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_Changing (304)
  4. TEMPORARI_REDIRECT (307)
  5. גרועה_(400)
  6. UnAuthorizeified (401)
  7. PAYMENT_חובה (402)
  8. FORBIDDEN (403)
  9. NOT_FOUND (404)
  10. METHOD_NOT_PERMISSION (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_חובה (428)
  18. TOO_MANY_REQUEST (429)
  19. INTERNAL_server_ERROR (500)
  20. NOT_IMPLEMENTED (501)
  21. SERVICE_UNAVAILABLE (503)

MOVED_PERMANENTLY (301)

קוד שגיאה תיאור
movedPermanently הבקשה הזו ובקשות עתידיות לאותה פעולה צריכות להישלח לכתובת ה-URL שצוינה בכותרת Location של התגובה הזו, במקום לכתובת ה-URL שאליה נשלחה הבקשה.

SEE_OTHER (303)

קוד שגיאה תיאור
seeOther הבקשה שלך עובדה בהצלחה. כדי לקבל את התשובה, יש לשלוח בקשת GET לכתובת ה-URL שצוינה בכותרת Location.
mediaDownloadRedirect הבקשה שלך עובדה בהצלחה. כדי לקבל את התשובה, יש לשלוח בקשת GET לכתובת ה-URL שצוינה בכותרת Location.

NOT_Changing (304)

קוד שגיאה תיאור
notModified התנאי שהוגדר לכותרת if-None- Match לא עמד. תגובה זו מציינת שהמסמך המבוקש לא השתנה ושצריך לאחזר תגובה שנשמרה במטמון. יש לבדוק את הערך של כותרת בקשת ה-HTTP של If-None-Match.

TEMPORARI_REDIRECT (307)

קוד שגיאה תיאור
temporaryRedirect כדי שבקשתך תטופל, עליך לשלוח אותה מחדש לכתובת האתר שצוינה בכותרת Location של תגובה זו.

ad_REQUEST (400)

קוד שגיאה תיאור
badRequest בקשת ה-API לא חוקית או שהיא נוצרה באופן שגוי. כתוצאה מכך, שרת ה-API לא הבין את הבקשה.
badBinaryDomainRequest הבקשה לדומיין הבינארי לא חוקית.
badContent אין תמיכה בסוג התוכן של נתוני הבקשה או בסוג התוכן של הבקשה החלקית.
badLockedDomainRequest בקשת הדומיין הנעול אינה חוקית.
corsRequestWithXOrigin בקשת CORS מכילה כותרת X-3 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 כדי למצוא את מפתח ה-API או כדי לקבל מפתח כזה.
lockedDomainCreationFailure אסימון ה-OAuth התקבל במחרוזת השאילתה, וה-API הזה אוסר על פורמטים של תגובות שאינם JSON או XML. אם אפשר, נסו לשלוח את אסימון ה-OAuth בכותרת ההרשאה.
notDownload ניתן לשלוח רק בקשות להורדת מדיה לנתיבים של /download/* כתובות URL. שולחים מחדש את הבקשה לאותו נתיב, אבל ללא הקידומת /download.
notUpload הבקשה נכשלה כי לא מדובר בבקשת העלאה, ורק בקשות העלאה יכולות להישלח אל /upload/* מזהי URI. צריך לשלוח מחדש את הבקשה לאותו נתיב, אבל ללא הקידומת /upload.
parseError שרת ה-API לא יכול לנתח את גוף הבקשה.
required בבקשת ה-API חסר מידע נדרש. המידע הנדרש יכול להיות פרמטר או מאפיין משאב.
tooManyParts הבקשה עם מספר החלקים נכשלה, כי היא מכילה יותר מדי חלקים
unknownApi ה-API שאליו הבקשה מתקשרת לא מזוהה.
unsupportedMediaProtocol הלקוח משתמש בפרוטוקול מדיה שאינו נתמך.
unsupportedOutputFormat ערך הפרמטר alt מציין פורמט פלט שאינו נתמך בשירות הזה. צריך לבדוק את הערך בפרמטר של הבקשה alt.
wrongUrlForUpload הבקשה היא בקשת העלאה, אך היא נכשלה כי היא לא נשלחה ל-URI הנכון. יש לשלוח בקשות העלאה ל-URI שמכילים את הקידומת /upload/*. צריך לשלוח מחדש את הבקשה לאותו נתיב, אבל עם הקידומת /upload.

UNAUTHORIZED (401)

קוד שגיאה תיאור
unauthorized המשתמש אינו מורשה לבצע את הבקשה.
authError פרטי הכניסה להרשאה שצוינו בבקשה לא חוקיים. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
expired פג תוקף הסשן. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
lockedDomainExpired הבקשה נכשלה כי פג התוקף של דומיין נעול שהיו בתוקף.
required כדי לבצע את בקשת ה-API הזו, על המשתמש להתחבר לחשבון. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.

PAYMENT_חובה (402)

קוד שגיאה תיאור
dailyLimitExceeded402 הגעת למגבלת התקציב היומית שהוגדרה על ידי המפתח.
quotaExceeded402 הפעולה שביקשת דורשת יותר משאבים ממה שהמכסה מאפשרת. נדרש תשלום כדי להשלים את הפעולה.
user402 הפעולה המבוקשת מחייבת סוג כלשהו של תשלום מהמשתמש המאומת.

FORBIDDEN (403)

קוד שגיאה תיאור
forbidden הפעולה המבוקשת אסורה ולא ניתן להשלים אותה.
accessNotConfigured הפרויקט שלך לא מוגדר לגישה ל-API הזה. צריך להשתמש ב-Google Developers Console כדי להפעיל את ה-API בפרויקט.
accessNotConfigured הפרויקט נחסם עקב ניצול לרעה. ניתן לעיין בכתובת http://support.google.com/code/go/developer_compliance.
accessNotConfigured הפרויקט סומן למחיקה.
accountDeleted חשבון המשתמש שמשויך לפרטי הכניסה של ההרשאה נמחק. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
accountDisabled חשבון המשתמש שמשויך לפרטי הכניסה של הבקשה הושבת. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
accountUnverified כתובת האימייל של המשתמש ששלח את הבקשה לא אומתה. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
concurrentLimitExceeded הבקשה נכשלה כי הגעת למגבלת השימוש בו-זמנית.
dailyLimitExceeded הגעת לתקרת המכסה היומית של ה-API.
dailyLimitExceeded הגעת למגבלת המכסה היומית, והפרויקט נחסם עקב ניצול לרעה. כדי לפתור את הבעיה, יש לעיין בטופס התמיכה בנושא תאימות ל-Google APIs.
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 לא מזהה את סכמת ההרשאות המשמשת לבקשה. יש לבדוק את הערך של כותרת בקשת ה-HTTP של Authorization.
userRateLimitExceeded הבקשה נכשלה כי הגעת למגבלת התעריפים לכל משתמש.
userRateLimitExceededUnreg הבקשה נכשלה כי הגעת למגבלה של הקצב למשתמש, ומפתח הלקוח לא זוהה בבקשה. עליך להשתמש ב-Google Developers Console (https://console.developers.google.com) כדי ליצור פרויקט לאפליקציה.
variableTermExpiredDailyExceeded הבקשה נכשלה כי פגה המכסה של מונח המשתנה והגעת למגבלה היומית.
variableTermLimitExceeded הבקשה נכשלה כי הגעת למגבלת המכסה של מונח המשתנה.

NOT_FOUND (404)

קוד שגיאה תיאור
notFound הפעולה המבוקשת נכשלה מכיוון שלא נמצא משאב המשויך לבקשה.
notFound לא נמצא משאב המשויך לבקשה. אם לא השתמשת ב-API הזה בשבועיים האחרונים, צריך לפרוס מחדש את האפליקציה App Engine ולנסות להתקשר אליה שוב.
unsupportedProtocol הפרוטוקול בבקשה אינו נתמך.

METHOD_NOT_PERMISSION (405)

קוד שגיאה תיאור
httpMethodNotAllowed שיטת ה-HTTP המשויכת לבקשה אינה נתמכת.

CONFLICT (409)

קוד שגיאה תיאור
conflict לא ניתן להשלים את בקשת ה-API כי הפעולה המבוקשת מתנגשת עם פריט קיים. לדוגמה, בקשה שמנסה ליצור פריט כפול תיצור התנגשות, אבל פריטים כפולים מזוהים בדרך כלל עם שגיאות ספציפיות יותר.
duplicate הפעולה המבוקשת נכשלה כי היא ניסתה ליצור משאב שכבר קיים.

GONE (410)

קוד שגיאה תיאור
deleted הבקשה נכשלה כי המשאב המשויך לבקשה נמחק

PRECONDITION_FAILED (412)

קוד שגיאה תיאור
conditionNotMet התנאי שהוגדר בכותרת של בקשת ה-HTTP של הבקשה If-Match או If-None-Match לא מתקיים. פרטים נוספים מופיעים בקטע ETag במפרט ה-HTTP. יש לבדוק את הערך של כותרת בקשת ה-HTTP של If-Match.

REQUEST_ENTITY_TOO_LARGE (413)

קוד שגיאה תיאור
backendRequestTooLarge הבקשה גדולה מדי.
batchSizeTooLarge הבקשה בכמות גדולה מכילה יותר מדי רכיבים.
uploadTooLarge הבקשה נכשלה מפני שהנתונים שנשלחו בבקשה גדולים מדי.

REQUEST_RANGE_NOT_SATISFIABLE (416)

קוד שגיאה תיאור
requestedRangeNotSatisfiable בבקשה צוין טווח שלא ניתן למלא אותו.

EXPECTATION_FAILED (417)

קוד שגיאה תיאור
expectationFailed השרת לא יכול לעמוד בציפיות של הלקוחות.

PRECONDITION_חובה (428)

קוד שגיאה תיאור
preconditionRequired הבקשה מחייבת תנאי מקדים שלא צוין. כדי שהבקשה תאושר, צריך לספק כותרת If-Match או If-None-Match עם הבקשה.

TOO_MANY_takeout (429)

קוד שגיאה תיאור
rateLimitExceeded יותר מדי בקשות נשלחו בתקופת זמן נתונה.

INTERNAL_server_ERROR (500)

קוד שגיאה תיאור
internalError הבקשה נכשלה עקב שגיאה פנימית.

NOT_IMPLEMENTED (501)

קוד שגיאה תיאור
notImplemented הפעולה המבוקשת לא יושמה.
unsupportedMethod הבקשה נכשלה מפני שהיא מנסה לבצע שיטה או פעולה לא ידועה.

SERVICE_UNAVAILABLE (503)

קוד שגיאה תיאור
backendError אירעה שגיאה בקצה העורפי.
backendNotConnected הבקשה נכשלה עקב שגיאת חיבור.
notReady שרת ה-API לא מוכן לקבלת בקשות.