Risoluzione degli errori relativi all'API

Questa pagina descrive come risolvere gli errori dell'API Google Sheets.

400 Bad Request

Questo errore indica che la richiesta non è valida. 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 Google Sheets, in genere significa che si è verificato un problema con l'API stessa. Segnala un bug nel tracker dei problemi 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 batchUpdate per combinare gli aggiornamenti correlati in un'unica richiesta. Presta attenzione quando esegui il batch di aggiornamenti di grandi dimensioni, in quanto potrebbe verificarsi 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 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 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 IMPORTRANGE formule.
  • Limita l'accesso al foglio di lavoro solo a chi ne ha bisogno.