Ce document décrit les limites et les quotas des demandes d'API de gestion et de création de rapports.
Google Analytics est utilisé par des millions de sites. Nous appliquons des limites et des quotas aux 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 d'être modifiés.
Cette vidéo présente les bonnes pratiques pour gérer les quotas de requêtes API Google Analytics.
Limites de quota générales
Les quotas suivants s'appliquent à l'API Management, à l'API Core Reporting v3, à l'API MCF Reporting, à l'API Metadata, à l'API User Deletion et à l'API Real Time Reporting:
- 50 000 requêtes par projet et par jour, augmentation possible
- 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, ce nombre est défini sur 100 requêtes pour 100 secondes et par utilisateur et peut être ajusté à une valeur maximale de 1 000. Toutefois, le nombre de requêtes adressées à l'API est limité à 10 requêtes par seconde et par utilisateur.
- Si votre application envoie toutes les requêtes API à partir d'une seule adresse IP (par exemple, pour le compte de vos utilisateurs), utilisez le paramètre
userIPouquotaUseravec chaque requête afin d'obtenir l'intégralité du quota de RPS pour chaque utilisateur. Consultez le récapitulatif des paramètres de requête standards pour plus de détails.
API Reporting
Les quotas suivants s'appliquent à toutes les API Reporting, y compris à l'API Core Reporting v3, à l'API Analytics Reporting version 4, à l'API Real Time v3 et à l'API Multi-channel Funnel v3:
- 10 000 demandes par vue (profil) et par jour (cette augmentation n'est pas possible)
- 10 requêtes simultanées par vue (profil) (impossible d'augmenter)
Ce comportement offre une approche plus précise et sûre de la gestion des quotas, de sorte que les appels fréquents à l'aide de l'API Analytics Real Time Reporting ne bloquent pas accidentellement tous les autres appels de l'API Analytics pour le reste de la journée pour une vue (profil) individuelle.
Erreurs de requêtes liées aux API de reporting
Si votre requête adressée à l'API Reporting échoue en raison d'une erreur de serveur, vous obtenez un code de réponse 500 ou 503. Vous pouvez la renvoyer. Toutefois, ne la renvoyez pas plus d'une fois si elle échoue à plusieurs reprises. Google Analytics vous permet d'effectuer les opérations suivantes:
- 10 requêtes ayant échoué par erreur de serveur, par projet, par vue (profil) et par heure
- 50 requêtes ayant échoué par erreur de serveur par projet, par vue (profil) et par jour
Si le nombre de requêtes ayant échoué dépasse ces quotas, le message d'erreur suivant 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 du serveur de requêtes, simplifiez la requête en : réduisant la plage de dates, le nombre de dimensions dans la requête ou le nombre de métriques qu'elle contient.
Ne renvoyez pas continuellement une demande ayant échoué. À la place, implémentez un intervalle exponentiel entre les tentatives pour renvoyer le modèle.
Les quotas de taux d'erreur du serveur sont appliqués sur des périodes glissantes pour chacun des quotas de taux d'erreur horaires et quotidiens. Une heure après la première erreur serveur d'un projet et d'une paire de vues, le quota est réinitialisé. Si une paire projet/vue envoie 10 erreurs de serveur en une heure, elle est bloquée par l'API jusqu'à l'heure suivant la première erreur du serveur.
Par exemple, si un projet et une paire de vues n'ont pas envoyé d'erreur de serveur au cours des dernières 24 heures, ce projet et cette vue n'auront utilisé 0 de ses 50 quotas. Imaginons que ce projet et cette vue envoient maintenant une erreur de serveur à 6h12. 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 lendemain. À 6h12 le jour suivant, le quota de taux d'erreur du serveur sera entièrement réinitialisé pour ce projet et cette vue.
Dépassement des limites de quota
Si le quota de demandes d'une 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:
- Le nombre de requêtes de lecture quotidiennes par projet (50 000 par défaut)
- Le nombre de requêtes d'écriture quotidiennes par projet (50 par défaut)
Pour afficher ou modifier les limites d'utilisation de votre projet, ou pour demander une augmentation des quotas, procédez comme suit :
- Si vous ne possédez pas encore de compte de facturation pour votre projet, créez-en un.
- Accédez à la page "API activées" de la bibliothèque d'API dans la console APIs, puis sélectionnez une API dans la liste.
- 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, veuillez remplir le formulaire de demande de quota pour l'API Analytics. Veillez à consulter les informations et à 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 API est API Reporting de Google Analytics. 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) figurent dans la section API Analytics de la console Google APIs.
Pour en savoir plus sur la gestion des quotas et sur le réglage de votre application pour l'utilisation des quotas, consultez Surveiller les API et limiter l'utilisation.