Khắc phục lỗi API

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

400 Bad Request

Lỗi này cho biết rằng yêu cầu có định dạng không đúng. Để khắc phục sự cố với 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 đang gặp vấn đề. Hãy 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

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 thông tin cập nhật liên quan thành một yêu cầu. Hãy thận trọng khi xử lý hàng loạt các thông tin cập nhật lớn vì điều 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ỉ truy xuất các giá trị cần thiết của 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 đợi luỹ tuyến (exponential backoff) 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 đị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.
  • 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ế sử dụng một bảng tính làm nguồn cho nhiều IMPORTRANGE công thức.
  • Chỉ cấp quyền truy cập vào bảng tính cho những người cần.