Les limites et quotas suivants s'appliquent à l'API Data.
Application des quotas
Toutes les requêtes adressées à l'API Google Analytics Data v1 nécessitent un projet Google Cloud et sont soumises aux quotas décrits sur cette page. Les quotas sont consommés, quelle que soit la méthode utilisée pour identifier le projet appelant, y compris :
- les requêtes authentifiées avec des identifiants OAuth 2.0 ;
- les requêtes authentifiées à l'aide d'une clé API uniquement.
Les clés API sont utilisées pour associer une requête à un projet Google Cloud spécifique à des fins de quotas et de facturation. Tous les appels d'API effectués à l'aide d'identifiants ou d'une clé API de votre projet seront comptabilisés dans les quotas applicables de votre projet et de la propriété Google Analytics.
Catégories de quotas
L'API Data comporte trois catégories de quotas de requêtes : Core, Temps réel et Entonnoir. Les requêtes d'API adressées aux méthodes Core sont facturées selon les quotas Core. Les requêtes d'API adressées aux méthodes Temps réel sont facturées selon les quotas Temps réel. Chaque requête ne consomme qu'un seul type de quota.
| Catégorie de quota | Méthodes d'API |
|---|---|
| Core | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility, createAudienceExports |
| Temps réel | runRealtimeReport |
| Entonnoir | runFunnelReport |
Quotas des propriétés Analytics
Toutes les requêtes consomment des quotas de propriété.
| Nom du quota | Limite de propriété standard | Limite de propriété Analytics 360 |
|---|---|---|
| Jetons Core par propriété et par jour | 200 000 | 2 000 000 |
| Jetons Core par propriété et par heure | 40 000 | 400 000 |
| Jetons Core par projet, par propriété et par heure | 14 000 | 140 000 |
| Requêtes Core simultanées par propriété | 10 | 50 |
| Erreurs de serveur Core par projet, par propriété et par heure | 10 | 50 |
| Jetons Temps réel par propriété et par jour | 200 000 | 2 000 000 |
| Jetons Temps réel par propriété et par heure | 40 000 | 400 000 |
| Jetons Temps réel par projet, par propriété et par heure | 14 000 | 140 000 |
| Requêtes Temps réel simultanées par propriété | 10 | 50 |
| Erreurs de serveur Temps réel par projet, par propriété et par heure | 10 | 50 |
| Jetons Entonnoir par propriété et par jour | 200 000 | 2 000 000 |
| Jetons Entonnoir par propriété et par heure | 40 000 | 400 000 |
| Jetons Entonnoir par projet, par propriété et par heure | 14 000 | 140 000 |
| Requêtes Entonnoir simultanées par propriété | 10 | 50 |
| Erreurs de serveur Entonnoir par projet, par propriété et par heure | 10 | 50 |
- Les requêtes simultanées sont mesurées par le nombre de requêtes exécutées simultanément. Pour réduire la simultanéité des requêtes, attendez que les requêtes précédentes soient terminées avant d'envoyer des requêtes supplémentaires.
- Les erreurs de serveur sont les codes 500 et 503. Les quotas d'erreurs de serveur ne sont facturés que lorsqu'une requête génère une erreur de serveur. Lorsque les quotas d'erreurs de serveur sont épuisés pour une paire projet/propriété, toutes les requêtes adressées à la propriété à partir du projet sont bloquées.
- Chaque requête consomme un quota pour les jetons par propriété et par heure, ainsi que pour les jetons par projet, par propriété et par heure. Cela signifie qu'une propriété doit être accessible par plus de trois projets pour que le quota "Jetons par propriété et par heure" puisse être épuisé avant le quota "Jetons par projet, par propriété et par heure".
Les propriétés sont autorisées à effectuer 120 requêtes potentiellement seuillées par heure. Les dimensions userAgeBracket, userGender, brandingInterest, audienceId et audienceName sont potentiellement seuillées. Les seuils permettent d'éviter que la personne qui consulte un rapport puisse déduire les données démographiques ou les centres d'intérêt d'un utilisateur spécifique.
Quota de jetons de propriété
Les jetons sont consommés à chaque requête adressée à l'API Google Analytics Data v1. Le nombre de jetons facturés dépend de la complexité de la requête. Bien que la plupart des requêtes facturent 10 jetons ou moins, les requêtes plus complexes en consomment davantage.
Facteurs qui influencent la consommation de jetons
Le coût exact des jetons pour une requête est déterminé au moment de l'exécution, ce qui rend la pré-estimation précise difficile. Le coût est influencé par une combinaison de facteurs liés à la requête elle-même et aux données sous-jacentes de la propriété Google Analytics. Ces facteurs peuvent entraîner des coûts plus élevés :
- Nombre de lignes : demande d'un plus grand nombre de lignes.
- Nombre de dimensions et de métriques : inclusion d'un plus grand nombre de dimensions et de métriques.
- Complexité du filtre : utilisation d'expressions de filtre complexes.
- Durée de la période : requête sur des périodes plus longues.
- Cardinalité des données : les dimensions à cardinalité élevée (nombreuses valeurs uniques, telles que
pagePath, dimensions personnalisées) peuvent augmenter considérablement le coût des jetons. - Volume d'événements de la propriété : les requêtes sur des propriétés avec un volume d'événements plus élevé peuvent consommer plus de jetons que la même requête sur une propriété avec moins de données.
Surveillance de l'utilisation des jetons
Le moyen le plus efficace de déterminer le coût des jetons pour vos appels d'API spécifiques
consiste à inclure le paramètre "returnPropertyQuota": true dans le corps de la requête.
La réponse de l'API inclut alors l'objet PropertyQuota, qui détaille les jetons consommés par cette requête spécifique et les soldes de quotas restants.