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

เอกสารนี้ระบุรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดบางส่วนที่ 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 ไม่พร้อมรับคำขอ