Khắc phục lỗi API

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

400 Bad Request

Lỗi này cho biết yêu cầu có định dạng không chính xác. Để khắc phục sự cố về 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 rằng chính API đó có vấn đề. Gửi báo cáo lỗi trên Công cụ theo dõi lỗi của API Trang tính kèm theo yêu cầu gây ra lỗi.

503 Service Unavailable

API Trang tính trả về lỗi 503 khi dịch vụ không hoạt động hoặc khi yêu cầu hoặc bảng tính có độ phức tạp cao. Sau đây là một số đề xuất để hạn chế tỷ lệ 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. Hãy thận trọng khi tạo lô các bản cập nhật lớn vì việ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 trên mỗi bảng tính ở mức 1 yêu cầu mỗi giây.
  • Đối với bảng tính lớn, chỉ truy xuất các giá trị bảng tính cần thiết 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 các trang tính được cập nhật thường xuyên, hãy xoay vòng sang một bảng tính mới theo định kỳ để giảm việc tích luỹ phiên bản.
  • Hạn chế sử dụng IMPORTRANGE, QUERY và các công thức phức tạp khác.
  • 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 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.