Resolver erros de API

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

400 Bad Request

Esse erro indica que a solicitação é inválida. Para solucionar 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 Sheets com a solicitação que causou o erro.

503 Service Unavailable

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

Solicitação

  • Use batchUpdate para combinar atualizações relacionadas em uma única solicitação. Tenha cuidado ao agrupar grandes atualizações, porque isso pode acionar um tempo limite.
  • Limite o número de solicitações simultâneas à API por planilha a uma solicitação por segundo.
  • Em planilhas grandes, recupere 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 espera exponencial ao fazer novas tentativas de solicitações.

Planilha

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