Limites et quotas pour les requêtes API

Ce document décrit les limites et les quotas des API de gestion et de création de rapports.

Google Analytics est utilisé par des millions de sites. Nous définissons des limites et des quotas sur les requêtes API pour empêcher le système de recevoir plus de données qu'il ne peut en traiter, et pour garantir une répartition équitable des ressources système. Les limites et les quotas sont susceptibles de changer.

Cette vidéo présente les bonnes pratiques de gestion des quotas de requêtes pour l'API Google Analytics.

Limites de quota générales

Les quotas suivants s'appliquent à l'API Management, à l'API Core Reporting version 3, à l'API MF Reporting, à l'API Metadata, à l'API User Deletion et à l'API Real Time Reporting:

  • 50 000 requêtes par projet et par jour, qui peuvent être augmentées
  • 10 requêtes par seconde (RPS) par adresse IP
    • Dans la console API, il existe un quota similaire appelé requêtes pour 100 secondes par utilisateur. Par défaut, il est défini sur 100 requêtes pour 100 secondes par utilisateur et peut être ajusté à une valeur maximale de 1 000. Cependant, le nombre de requêtes adressées à l'API est limité à 10 requêtes par seconde et par utilisateur.
    • Si votre application effectue toutes les requêtes API à partir d'une seule adresse IP (c'est-à-dire au nom de vos utilisateurs), utilisez le paramètre userIP ou quotaUser avec chaque requête afin d'obtenir un quota de RPS complet pour chaque utilisateur. Pour en savoir plus, consultez le résumé des paramètres de requête standards.

API Reporting

Les quotas suivants s'appliquent à toutes les API Reporting, y compris les API Core Reporting v3, Analytics Reporting v4, Real Time v3 et Multi-channel Funnel v3 :

  • 10 000 requêtes par vue (profil) par jour (augmentation impossible)
  • 10 requêtes simultanées par vue (profil) (impossible d'augmenter)

Erreurs de requête des API de création de rapports

Si votre requête à l'API Reporting échoue avec une erreur de serveur, vous recevez un code de réponse 500 ou 503. Vous pouvez la renvoyer. Cependant, ne la renvoyez pas plus d'une fois si elle échoue à plusieurs reprises. Google Analytics permet:

  • 10 erreurs de serveur ont échoué par projet, par vue (profil) et par heure
  • 50 erreurs de serveur qui ont échoué par projet et par vue (profil) par jour

Si le nombre de requêtes ayant échoué dépasse ces quotas, l'erreur suivante s'affiche:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

Pour réduire le risque d'erreur d'un serveur de requêtes, simplifiez la requête en réduisant la plage de dates, le nombre de dimensions ou le nombre de métriques dans la requête.

Ne renvoyez pas une requête ayant échoué. À la place, implémentez un intervalle exponentiel entre les tentatives pour le renvoyer.

Les quotas de taux d'erreur du serveur sont appliqués sur des périodes glissantes pour chacun des quotas horaires et quotidiens. Une heure après une première erreur de serveur et de projet, le quota est réinitialisé. Si une paire projet/vue envoie 10 erreurs de serveur en une heure, la paire projet/vue est bloquée depuis l'API jusqu'à l'heure suivant la première erreur de serveur.

Par exemple, si une paire projet/vue n'a pas envoyé d'erreur de serveur au cours des dernières 24 heures, ce projet et cette vue ont utilisé 0 de son quota de 50. Supposons que ce projet et cette vue envoient une erreur de serveur à 6h12 du matin. Si ce projet et cette vue envoient 49 erreurs de serveur supplémentaires avant 6h12 le jour suivant, ce projet et cette vue seront bloqués jusqu'à 6h12 le jour suivant. À 6h12 le lendemain, le quota de taux d'erreur du serveur sera entièrement réinitialisé pour ce projet et cette vue.

API Reporting Reporting version 4

Ces quotas ne s'appliquent qu'à l'API Reporting v4:

  • Nombre de requêtes par jour et par projet: 50 000
  • Nombre de requêtes par vue (profil) par jour: 10 000 (ne peut pas être augmenté)
  • Nombre de requêtes pour 100 secondes par projet: 2 000
  • Nombre de requêtes pour 100 secondes par utilisateur et par projet: 100 (vous pouvez passer à 1 000 dans la console Google APIs).

Vous pouvez afficher les quotas de votre projet dans la console Google APIs.

Quota basé sur les ressources

L'API Reporting v4 est également régie par le quota basé sur les ressources facultatif, qui permet d'utiliser des seuils d'échantillonnage plus élevés pour les clients Analytics 360.

Dépassement des limites de quota

Si le quota de demande d'API Google Analytics est dépassé, l'API renvoie un code d'erreur 403 ou 429 et un message indiquant que le compte a dépassé le quota. Pour en savoir plus, consultez les Conditions d'utilisation.

Demander des quotas supplémentaires

Vous pouvez uniquement demander à augmenter:

Pour afficher ou modifier les limites d'utilisation de votre projet, ou pour demander une augmentation des quotas, procédez comme suit :

  1. Si vous ne possédez pas encore de compte de facturation pour votre projet, créez-en un.
  2. Accédez à la page "API activées" de la bibliothèque d'API dans la console API, puis sélectionnez une API dans la liste.
  3. Sélectionnez Quotas pour afficher et modifier les paramètres associés aux quotas. Pour afficher les statistiques d'utilisation, sélectionnez Utilisation.

Pour demander une augmentation du quota maximal, utilisez le formulaire de demande de quota pour l'API Analytics. Assurez-vous de consulter les informations et de suivre les instructions du formulaire de demande de quota avant d'envoyer votre demande. Pour l'API Reporting v4, le nom de l'API dans la console Google APIs est Google Analytics Reporting API. Toutes les autres API v3 (par exemple, L'API Management v3, l'API Core Reporting v3, l'API Real Time Reporting v3 et l'API User Deletion v3) sont répertoriées dans la section API Analytics de la console Google APIs.

Pour en savoir plus sur la gestion des quotas et découvrir comment ajuster l'utilisation des quotas pour votre application, consultez la page Surveiller des API et limiter l'utilisation.