In questa pagina viene descritto come risolvere gli errori relativi all'API Fogli.
400 Bad Request
Questo errore indica che il formato della richiesta non era corretto. Per la risoluzione dei problemi relativi a queste richieste, consulta la documentazione di riferimento e la pagina di assistenza.
500 Internal Server Error
Se riscontri errori 500 durante l'utilizzo dell'API Fogli, in genere significa che c'è un problema con l'API stessa. Invia una segnalazione 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 di seguito alcuni suggerimenti per limitare la frequenza di errori 503 modificando le richieste API e il foglio di lavoro sottostante.
Richiesta
- Utilizza
batchUpdateper combinare gli aggiornamenti correlati in un'unica richiesta. Presta attenzione quando raggruppi aggiornamenti di grandi dimensioni, poiché ciò potrebbe causare un timeout. - Limita il numero di richieste in parallelo all'API per foglio di lavoro a una richiesta al secondo.
- Per i fogli di lavoro di grandi dimensioni, recupera solo i valori necessari utilizzando
la notazione A1 e limita l'utilizzo di
includeGridData. - Utilizza le maschere di campo per limitare la quantità di dati restituiti dall'API.
- Utilizza il backoff esponenziale quando ritenta 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,QUERYe 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.