Resolver erros de API

Nesta página, descrevemos como solucionar erros com a API Google Sheets.

400 Bad Request

Esse erro indica que a solicitação estava malformada. 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ê estiver encontrando erros 500 ao usar a API Google Sheets, isso geralmente indica um problema com a API em si. Envie um relatório de bug no Issue Tracker da API Google Sheets com a solicitação que causou o erro.

503 Service Unavailable

A API Google Sheets retorna um erro 503 quando o serviço está indisponível ou quando a complexidade da solicitação ou da planilha é alta. Confira 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 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 solicitação por segundo.
  • Para 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 a espera exponencial para ajudar nas tentativas.

Planilha

  • Para planilhas atualizadas com frequência, crie 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 fonte para muitas fórmulas de IMPORTRANGE.
  • Limite o acesso à planilha apenas às pessoas que precisam dela.