Risoluzione degli errori relativi all'API

Questa pagina descrive come risolvere i problemi relativi all'API Fogli.

400 Bad Request

Questo errore indica che la richiesta è in un formato non valido. Per la risoluzione dei problemi relativi a queste richieste, consulta la documentazione di riferimento e la pagina di assistenza.

500 Internal Server Error

Se si verificano errori 500 durante l'utilizzo dell'API Fogli, solitamente indica che esiste un problema con l'API stessa. Invia un report di bug nel tracker dei problemi dell'API Fogli con la richiesta che ha causato l'errore.

503 Service Unavailable

L'API Fogli restituisce un errore 503 quando il servizio non è disponibile o quando la complessità della richiesta o del foglio di lavoro è elevata. Di seguito sono riportati alcuni suggerimenti per limitare la frequenza degli errori 503 modificando le richieste API e il foglio di lavoro sottostante.

Richiesta

  • Utilizza batchUpdate per combinare gli aggiornamenti correlati in una singola richiesta. Presta attenzione quando raggruppi aggiornamenti di grandi dimensioni, in quanto ciò potrebbe attivare un timeout.
  • Limita il numero di richieste simultanee all'API per foglio di lavoro a 1 richiesta al secondo.
  • Per i fogli di lavoro di grandi dimensioni, recupera solo i valori necessari utilizzando la notazione A1 e limita l'uso di includeGridData.
  • Utilizza le maschere di campo per limitare la quantità di dati restituiti dall'API.
  • Utilizza il backoff esponenziale quando riprovi a inviare le richieste.

Foglio di lavoro

  • Per i fogli aggiornati di frequente, passa periodicamente a un nuovo foglio di lavoro per ridurre l'accumulo di versioni.
  • Limita l'utilizzo di IMPORTRANGE, QUERY e altre formule complesse.
  • Valuta la possibilità di suddividere i fogli di lavoro di grandi dimensioni in più fogli di lavoro.
  • Limita l'utilizzo di un singolo foglio di lavoro come origine per molte formule IMPORTRANGE.
  • Limita l'accesso al foglio di lavoro solo a chi ne ha bisogno.