Resolver erros de API

Esta página descreve como resolver erros com a API Sheets.

400 Bad Request

Esse erro indica que a solicitação estava incorreta. Para resolver problemas com essas solicitações, consulte a documentação de referência e a página de suporte.

500 Internal Server Error

Se você encontrar erros 500 ao usar a API Sheets, isso normalmente indica que há um problema com a própria API. Envie um relatório de bug no Issue Tracker da API Planilhas com a solicitação que causou o erro.

503 Service Unavailable

A API Sheets retorna um erro 503 quando o serviço está indisponível ou quando a complexidade da solicitação ou planilha é alta. Confira a seguir algumas sugestões para limitar a taxa de erros 503 modificando as solicitações da API e a planilha.

Solicitação

  • Use batchUpdate para combinar atualizações relacionadas em uma única solicitação. Tenha cuidado ao agrupar atualizações grandes, porque isso pode acionar um tempo limite.
  • Limite o número de solicitações simultâneas para a API por planilha a uma por segundo.
  • Para planilhas grandes, extraia apenas os valores necessários usando a notação A1 e limite o uso de includeGridData.
  • Use máscaras de campo para limitar a quantidade de dados retornados pela API.
  • Use a espera exponencial para ajudar nas tentativas.

Planilha

  • Para planilhas atualizadas com frequência, alterne para uma nova planilha periodicamente para reduzir a acumulação de versões.
  • Limite o uso de IMPORTRANGE, QUERY e outras fórmulas complexas.
  • Considere dividir planilhas grandes em várias planilhas.
  • Limite o uso de uma única planilha como fonte de muitas fórmulas IMPORTRANGE.
  • Limite o acesso à planilha apenas para quem precisa.