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

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

400 Bad Request

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

500 Internal Server Error

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

503 Service Unavailable

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

ส่งคำขอ

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

สเปรดชีต

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