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 estava malformada. Para solucionar esses pedidos, consulte a documentação de referência e a página de suporte.

500 Internal Server Error

Se você estiver recebendo erros 500 ao usar a API Sheets, isso geralmente indica que há um problema com a própria API. Registre um relatório de bugs 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. 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, alterne 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 planilhas.
  • Limite o uso de uma única planilha como fonte para muitas IMPORTRANGE fórmulas.
  • Limite o acesso à planilha apenas para quem precisa dela.