การตอบสนองต่อข้อผิดพลาดมาตรฐาน

เอกสารนี้ระบุรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดบางส่วนที่ 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 ในส่วนหัวการให้สิทธิ์แทน
notDownload คำขอที่ส่งไปยังเส้นทาง URL /download/* ได้มีเพียงคำขอดาวน์โหลดสื่อเท่านั้น ให้ส่งคำขอไปยังเส้นทางเดิมอีกครั้ง แต่ไม่ต้องใส่คำนำหน้า /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 นี้ โปรดใช้ 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 ที่ไม่ได้ตรวจสอบสิทธิ์ถึงขีดจำกัดรายวันแล้ว คุณต้องลงชื่อสมัครใช้ผ่าน Google Developers Console เพื่อใช้งาน API ดังกล่าวต่อไป
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 Developer Console (https://console.developers.google.com) เพื่อสร้างโปรเจ็กต์สำหรับแอปพลิเคชันของคุณ
variableTermExpiredDailyExceeded คำขอไม่สำเร็จเพราะโควต้าระยะเวลาตัวแปรหมดอายุและมีการใช้งานถึงขีดจำกัดต่อวันแล้ว
variableTermLimitExceeded คำขอล้มเหลวเพราะมีการใช้งานถึงขีดจำกัดโควต้าระยะเวลาตัวแปรแล้ว

NOT_FOUND (404)

รหัสข้อผิดพลาด คำอธิบาย
notFound การดำเนินการที่ขอล้มเหลวเพราะไม่พบทรัพยากรที่เชื่อมโยงกับคำขอ
notFound ไม่พบทรัพยากรที่เชื่อมโยงกับคำขอ หากคุณยังไม่ได้ใช้ API นี้ในช่วง 2 สัปดาห์ที่ผ่านมา โปรดทำให้แอป 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 ไม่พร้อมรับคำขอ