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.