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 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.