Khắc phục lỗi API

Trang này mô tả cách khắc phục lỗi với Sheets API.

400 Bad Request

Lỗi này cho biết yêu cầu không đúng định dạng. Để khắc phục sự cố liên quan đến các yêu cầu này, hãy xem tài liệu tham khảo và trang hỗ trợ.

500 Internal Server Error

Nếu bạn gặp lỗi 500 khi sử dụng API Trang tính, thì điều này thường cho biết có vấn đề với chính API. Gửi báo cáo lỗi trên Công cụ theo dõi lỗi của Sheets API kèm theo yêu cầu gây ra lỗi.

503 Service Unavailable

Sheets API trả về lỗi 503 khi dịch vụ không hoạt động hoặc khi độ phức tạp của yêu cầu hoặc bảng tính ở mức cao. Sau đây là một số đề xuất để hạn chế tần suất xuất hiện lỗi 503 bằng cách sửa đổi các yêu cầu API và bảng tính cơ bản.

Yêu cầu

  • Sử dụng batchUpdate để kết hợp các bản cập nhật có liên quan thành một yêu cầu duy nhất. Hãy thận trọng khi gộp các bản cập nhật lớn vì thao tác này có thể kích hoạt thời gian chờ.
  • Giới hạn số lượng yêu cầu đồng thời gửi đến API cho mỗi bảng tính là 1 yêu cầu mỗi giây.
  • Đối với các bảng tính lớn, chỉ cần truy xuất các giá trị cần thiết trong bảng tính bằng cách sử dụng ký hiệu A1 và hạn chế sử dụng includeGridData.
  • Sử dụng mặt nạ trường để giới hạn lượng dữ liệu mà API trả về.
  • Sử dụng thuật toán thời gian đợi luỹ thừa khi thử lại các yêu cầu.

Bảng tính

  • Đối với những trang tính thường xuyên được cập nhật, hãy định kỳ chuyển sang một bảng tính mới để giảm số lượng phiên bản tích luỹ.
  • Hạn chế sử dụng IMPORTRANGE, QUERY và các công thức phức tạp khác.
  • Hãy cân nhắc việc chia các bảng tính lớn thành nhiều bảng tính.
  • Hạn chế việc sử dụng một bảng tính duy nhất làm nguồn cho nhiều công thức IMPORTRANGE.
  • Chỉ cấp quyền truy cập vào bảng tính cho những người cần thiết.