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'est pas valide. Pour résoudre ces requêtes, 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'Issue Tracker 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 que 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. Faites preuve de prudence lorsque vous effectuez des mises à jour groupées volumineuses, car cela peut déclencher un délai avant expiration.
  • Limitez le nombre de requêtes simultané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 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 seule feuille de calcul comme source de nombreuses formules IMPORTRANGE.
  • Limitez l'accès à la feuille de calcul aux seules personnes qui en ont besoin.