Limites et quotas concernant les requêtes API

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 userIP ou quotaUser avec 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 de gestion

Google Analytics applique des quotas aux requêtes envoyées aux API de gestion suivantes:

Écrire des API

Ces quotas s'appliquent aux requêtes d'écriture (insert, update, patch et delete) :

  • 50 requêtes d'écriture par projet et par jour, augmentation possible
  • 1,5 requêtes par seconde (RPS) par ID de compte

Erreurs de requête d'écriture

Si votre requête d'écriture échoue et que vous obtenez un code de réponse 500 ou 503, vous pouvez la renvoyer. Google Analytics permet:

  • 50 requêtes d'écriture ayant échoué par heure

Si vous tentez d'envoyer plus de 50 requêtes d'écriture ayant échoué par heure, l'erreur suivante s'affiche:

Quota Error: The number of recent failed writes is too high.

Au lieu de renvoyer continuellement une requête d'écriture ayant échoué, implémentez un intervalle exponentiel entre les tentatives.

API Data Import

Ces quotas sont spécifiques à la ressource Uploads:

  • Limites de stockage Importation de données étendues à vie (ne s'applique pas aux données d'appel envoyées depuis les API et SDK de collecte des données) :
  • 50 ensembles de données par propriété
  • 50 opérations d'importation par propriété et par jour
  • 1 Go par fichier importé
  • Limites spécifiques aux données de coût :
    • 100 Mo par date (ga:date) et par ensemble de données. Par exemple, si vous importez 50 Mo de données pour le 10/10/2014 et 50 Mo pour le 10/10/2014 lors d'une seconde importation, vous avez atteint la limite de 100 Mo pour le 10/10/2014 pour cet ensemble de données.

API Experiments

Ce quota ne s'applique qu'aux tests:

  • 12 tests par vue (profil)

Les tests avec l'un des statuses suivants sont comptabilisés dans ce quota:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Les tests terminés (état = ENDED) pendant plus d'un jour ne sont pas comptabilisés dans ce quota.

API Unsample Reports

Ces quotas ne s'appliquent qu'aux rapports non échantillonnés:

  • Les requêtes API permettant de créer des rapports non échantillonnés sont comptabilisées dans le quota général Requêtes d'écriture.
  • L'API utilise le même système de jetons par propriété, par jour que l'interface Web pour créer des rapports non échantillonnés.
  • Le nombre maximal de rapports non échantillonnés autorisé est de 3 500. Lorsque cette limite est atteinte, si vous essayez de créer d'autres rapports non échantillonnés avec les résultats de l'API, l'erreur suivante s'affiche : 
    Error creating this entity. You have reached the maximum allowed entities of this type.

API User Permission

Ce quota ne s'applique qu'aux autorisations de l'utilisateur:

  • Un utilisateur ne peut pas posséder plus de 100 comptes Analytics. L'ajout d'un utilisateur disposant de 100 comptes Analytics à un nouveau compte entraîne une erreur.

Les quotas suivants s'appliquent aux requêtes d'écriture par lot (delete, insert, update) destinées aux autorisations de l'utilisateur:

  • 300 requêtes d'autorisation d'écriture utilisateur par requête par lot
  • 30 demandes d'autorisation d'écriture utilisateur par lot, comptabilisées comme une requête d'écriture

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:

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