แก้ปัญหาข้อผิดพลาดของ API

หน้านี้จะอธิบายวิธีแก้ปัญหาข้อผิดพลาดเกี่ยวกับ Sheets API

400 Bad Request

ข้อผิดพลาดนี้บ่งบอกว่าคําขอมีรูปแบบไม่ถูกต้อง หากต้องการแก้ปัญหาเกี่ยวกับคำขอเหล่านี้ โปรดดูเอกสารอ้างอิงและหน้าการสนับสนุน

500 Internal Server Error

หากพบข้อผิดพลาด 500 เมื่อใช้ Sheets API แสดงว่า API เองมีปัญหา รายงานข้อบกพร่องใน เครื่องมือติดตามปัญหาของชีต API พร้อมคำขอที่ทำให้เกิดข้อผิดพลาด

503 Service Unavailable

ชีต API จะแสดงข้อผิดพลาด 503 เมื่อบริการไม่พร้อมใช้งานหรือเมื่อคำขอหรือสเปรดชีตมีความซับซ้อนสูง ต่อไปนี้คือคำแนะนำบางส่วนในการจำกัดอัตราข้อผิดพลาด 503 ด้วยการแก้ไขคำขอ API และสเปรดชีตที่เกี่ยวข้อง

ส่งคำขอ

  • ใช้ batchUpdate เพื่อรวมการอัปเดตที่เกี่ยวข้องไว้ในคําขอเดียว โปรดใช้ความระมัดระวังเมื่ออัปเดตหลายรายการพร้อมกันเนื่องจากอาจทริกเกอร์การหมดเวลา
  • จำกัดจำนวนคำขอ API ที่ส่งพร้อมกันต่อสเปรดชีตไว้ที่ 1 คำขอต่อวินาที
  • สําหรับสเปรดชีตขนาดใหญ่ ให้ดึงเฉพาะค่าสเปรดชีตที่จําเป็นโดยใช้การเขียน A1 และจํากัดการใช้ includeGridData
  • ใช้มาสก์ฟิลด์เพื่อจำกัดปริมาณข้อมูลที่ API แสดงผล
  • ใช้ Exponential Backoff เมื่อลองส่งคำขออีกครั้ง

สเปรดชีต

  • สำหรับชีตที่อัปเดตบ่อย ให้เปลี่ยนไปใช้สเปรดชีตใหม่เป็นระยะเพื่อลดจำนวนเวอร์ชันที่สะสม
  • จํากัดการใช้ IMPORTRANGE, QUERY และสูตรที่ซับซ้อนอื่นๆ
  • ลองแยกสเปรดชีตขนาดใหญ่ออกเป็นหลายๆ สเปรดชีต
  • จำกัดการใช้สเปรดชีตเดียวเป็นแหล่งที่มาของสูตร IMPORTRANGE หลายสูตร
  • จำกัดสิทธิ์เข้าถึงสเปรดชีตให้เฉพาะผู้ที่จําเป็นเท่านั้น