Résoudre les erreurs liées à l'API

Cette page explique comment résoudre les erreurs liées à l'API Sheets.

400 Bad Request

Cette erreur indique que la requête n'a pas été rédigée correctement. Pour résoudre les problèmes liés à ces demandes, consultez la documentation de référence et la page d'assistance.

500 Internal Server Error

Si vous rencontrez des erreurs 500 lorsque vous utilisez l'API Sheets, cela indique généralement qu'il y a un problème avec l'API elle-même. Signalez un bug dans l'outil de suivi des problèmes de l'API Sheets en indiquant la requête qui a provoqué l'erreur.

503 Service Unavailable

L'API Sheets renvoie une erreur 503 lorsque le service est indisponible ou lorsque la requête ou la feuille de calcul sont très complexes. Vous trouverez ci-dessous quelques suggestions pour limiter le taux d'erreurs 503 en modifiant les requêtes API et la feuille de calcul sous-jacente.

Requête

  • Utilisez batchUpdate pour combiner les mises à jour associées en une seule requête. Soyez prudent lorsque vous regroupez de grandes mises à jour, car cela peut entraîner un délai d'expiration.
  • Limitez le nombre de requêtes simultanées adressées à l'API par feuille de calcul à une requête par seconde.
  • Pour les grandes feuilles de calcul, ne récupérez que les valeurs nécessaires à l'aide de la notation A1 et limitez l'utilisation de includeGridData.
  • Utilisez des masques de champ pour limiter la quantité de données renvoyées par l'API.
  • Utilisez un intervalle exponentiel entre les tentatives de demande.

Feuille de calcul

  • Pour les feuilles de calcul fréquemment mises à jour, passez régulièrement à une nouvelle feuille de calcul afin de réduire l'accumulation de versions.
  • Limitez l'utilisation de IMPORTRANGE, QUERY et d'autres formules complexes.
  • Envisagez de diviser les feuilles de calcul volumineuses en plusieurs feuilles de calcul.
  • Limitez l'utilisation d'une même feuille de calcul comme source pour de nombreuses formules IMPORTRANGE.
  • Limitez l'accès à la feuille de calcul aux seules personnes qui en ont besoin.