תגובות שגיאה רגילות

במסמך הזה מפורטים חלק מקודי השגיאות והודעות השגיאה שמתקבלים מ-Google APIs. השגיאות המפורטות כאן הן במיוחד בדומיין הגלובלי (או בדומיין ברירת המחדל) של Google APIs. ממשקי 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_MODIFIED (304)
  4. ‎TEMPORARY_REDIRECT (307)
  5. ‎BAD_REQUEST (400)
  6. ‎UNAUTHORIZED (401)
  7. ‎PAYMENT_REQUIRED (402)
  8. ‎FORBIDDEN (403)
  9. ‎NOT_FOUND (404)
  10. ‎METHOD_NOT_ALLOWED (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_REQUIRED (428)
  18. ‎TOO_MANY_REQUESTS (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_MODIFIED (304)

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

‎TEMPORARY_REDIRECT (307)

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

‎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 כדי למצוא את מפתח ה-API או כדי לקבל מפתח כזה.
lockedDomainCreationFailure אסימון ה-OAuth התקבל במחרוזת השאילתה, שה-API הזה לא מתיר שימוש בפורמטים שאינם JSON או XML לתגובות. אם אפשר, עדיף במקום זאת לשלוח את אסימון ה-OAuth בכותרת Authorization.
notDownload אפשר לשלוח בקשות להורדות של מדיה רק לנתיבי /download/* של כתובות URL. צריך לשלוח את הבקשה מחדש לאותו נתיב, אבל בלי הקידומת /download.
notUpload הבקשה נכשלה כי היא לא בקשת העלאה. ניתן לשלוח למזהי ה-URI /upload/* רק בקשות העלאה. צריך לשלוח מחדש את מחדש לאותו נתיב, אבל בלי הקידומת /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_REQUIRED (402)

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

‎FORBIDDEN (403)

קוד שגיאה תיאור
forbidden הפעולה המבוקשת אסורה ואי אפשר להשלים אותה.
accessNotConfigured לפרויקט שלכם לא הוגדרה גישה ל-API הזה. צריך להפעיל את ה-API בפרויקט ב-Google Developers Console.
accessNotConfigured הפרויקט נחסם בגלל התנהגות פוגעת. למידע נוסף: http://support.google.com/code/go/developer_compliance.
accessNotConfigured הפרויקט סומן למחיקה.
accountDeleted חשבון המשתמש המשויך לפרטי הכניסה של הרשאת הבקשה נמחק. צריך לבדוק את הערך של כותרת בקשת ה-‏HTTP Authorization.
accountDisabled חשבון המשתמש המשויך לפרטי הכניסה של הרשאת הבקשה הושבת. צריך לבדוק את הערך של כותרת בקשת ה-‏HTTP Authorization.
accountUnverified כתובת האימייל של המשתמש שהגיש את הבקשה לא מאומתת. צריך לבדוק את הערך של כותרת בקשת ה-‏HTTP Authorization.
concurrentLimitExceeded הבקשה נכשלה כי הגעתם למגבלת השימוש בו-זמנית (concurrent).
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 לא מזהה את ה-Scheme של ההרשאה שנעשה בו שימוש לבקשה. צריך לבדוק את הערך של כותרת בקשת ה-‏HTTP Authorization.
userRateLimitExceeded הבקשה נכשלה כי הגעתם להגבלת קצב של יצירת בקשות לכל משתמש.
userRateLimitExceededUnreg הבקשה נכשלה כי הגעתם להגבלת קצב של יצירת בקשות לכל משתמש, ומפתח הלקוח לא זוהה בבקשה. כדי ליצור פרויקט לאפליקציה, צריך להשתמש ב-Google Developer 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 אין עמידה בתנאי שהוגדר בכותרת בקשת ה-‏HTTP If-Match או If-None-Match של הבקשה. פרטים נוספים מופיעים בקטע ETag שבמפרט ה-HTTP. צריך לבדוק את הערך של כותרת בקשת ה-‏HTTP If-Match.

‎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 לא מוכן לקבלת בקשות.