Khắc phục lỗi API

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

400 Bad Request

Lỗi này cho biết rằng yêu cầu không đúng định dạng. Để khắc phục các sự cố này yêu cầu, 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ường cho biết rằng có vấn đề với chính API. Báo cáo lỗi báo cáo trên Công cụ theo dõi lỗi của API Trang tính với 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 độ 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 giúp 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 nội dung cập nhật liên quan thành một yêu cầu duy nhất. Hãy thận trọng khi phân lô các bản cập nhật lớn vì thao tác này có thể kích hoạt .
  • Giới hạn số lượng yêu cầu đồng thời đối với API cho mỗi bảng tính ở mức 1 mỗi giây.
  • Đối với bảng tính lớn, chỉ 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à giới hạn việc sử dụng includeGridData.
  • Sử dụng mặt nạ trường để hạn chế 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 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 sang một bảng tính mới định kỳ để 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ế việc sử dụng một bảng tính duy nhất làm nguồn cho nhiều IMPORTRANGE công thức.
  • Giới hạn quyền truy cập vào bảng tính chỉ cho những người cần đến.