Questa pagina descrive come risolvere gli errori relativi all'API Google Sheets.
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 Sheets, in genere indica che si è verificato un problema con l'API stessa. Segnala un bug nel Issue Tracker dell'API Sheets con la richiesta che ha causato l'errore.
503 Service Unavailable
L'API Sheets 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
batchUpdateper combinare gli aggiornamenti correlati in un'unica richiesta. Presta attenzione quando esegui l'aggiornamento batch di grandi dimensioni, in quanto 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'utilizzo 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,QUERYe altre formule complesse. - Valuta la possibilità di dividere 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.