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

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

400 Bad Request

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

500 Internal Server Error

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

503 Service Unavailable

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

ส่งคำขอ

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

สเปรดชีต

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