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

Cette page explique comment résoudre les erreurs avec l'API Sheets.

400 Bad Request

Cette erreur indique que le format de la requête était incorrect. Pour résoudre ces problèmes, consultez la documentation de référence et la page d'assistance.

500 Internal Server Error

Si vous rencontrez des erreurs 500 lors de l'utilisation de l'API Sheets, cela indique généralement un problème lié à l'API elle-même. Enregistrez un rapport de bug dans l'outil de suivi des problèmes de l'API Sheets avec la requête à l'origine de l'erreur.

503 Service Unavailable

L'API Sheets renvoie une erreur 503 lorsque le service est indisponible, ou lorsque la complexité de la requête ou de la feuille de calcul est élevée. 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 dans une seule requête. Soyez prudent lorsque vous regroupez des mises à jour volumineuses, car cela peut déclencher un délai avant expiration.
  • Limitez le nombre de requêtes simultanées adressées à l'API par feuille de calcul à 1 requête par seconde.
  • Pour les feuilles de calcul volumineuses, récupérez uniquement les valeurs nécessaires à l'aide du format 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 lors de nouvelles tentatives de requêtes.

Spreadsheet

  • Pour les feuilles fréquemment mises à jour, effectuez régulièrement une rotation vers 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 seule feuille de calcul comme source pour de nombreuses formules IMPORTRANGE.
  • Limitez l'accès à la feuille de calcul aux seuls utilisateurs qui en ont besoin.