Les limites et quotas suivants s'appliquent à l'API Data.
Application des quotas
Toutes les requêtes envoyé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 :
- Requêtes authentifiées avec des identifiants OAuth 2.0.
- Requêtes authentifiées à l'aide d'une clé API uniquement.
Les clés API permettent d'associer une requête à un projet Google Cloud spécifique à des fins de quota 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 quatre catégories de quotas de requêtes : "Core", "Realtime", "Funnel" et "Chat".
Les requêtes API envoyées aux méthodes Core sont facturées selon les quotas Core. Les requêtes d'API envoyées aux méthodes Realtime sont facturées selon les quotas Realtime. Les requêtes API envoyées aux méthodes Funnel sont facturées selon les quotas Funnel. Les requêtes API envoyées aux méthodes Chat sont facturées selon les quotas Chat. 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 |
| Chat | properties.chat |
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és Analytics 360 |
|---|---|---|
| Jetons principaux par propriété et par jour | 200 000 | 2 000 000 |
| Jetons principaux par propriété et par heure | 40 000 | 400 000 |
| Jetons principaux par projet, par propriété et par heure | 14 000 | 140 000 |
| Requêtes simultanées principales par propriété | 10 | 50 |
| Erreurs serveur principales par projet, par propriété et par heure | 10 | 50 |
| Jetons en temps réel par propriété et par jour | 200 000 | 2 000 000 |
| Jetons en temps réel par propriété et par heure | 40 000 | 400 000 |
| Jetons en temps réel par projet, par propriété et par heure | 14 000 | 140 000 |
| Nombre de requêtes simultanées en temps réel par propriété | 10 | 50 |
| Erreurs de serveur en temps réel par projet, par propriété et par heure | 10 | 50 |
| Jetons d'entonnoir par propriété et par jour | 200 000 | 2 000 000 |
| Jetons de l'entonnoir par propriété et par heure | 40 000 | 400 000 |
| Jetons d'entonnoir par projet, par propriété et par heure | 14 000 | 140 000 |
| Requêtes simultanées dans l'entonnoir par propriété | 10 | 50 |
| Erreurs de serveur d'entonnoir par projet, par propriété et par heure | 10 | 50 |
| Jetons de chat par propriété et par jour | 3 750 000 | 3 750 000 |
| Jetons de chat par propriété et par heure | 500 000 | 500 000 |
- Les requêtes simultanées sont mesurées par le nombre de requêtes exécutées en même temps. Pour réduire la simultanéité des requêtes, attendez que les requêtes précédentes soient terminées avant d'en envoyer d'autres.
- Les erreurs de serveur correspondent aux 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é depuis le projet sont bloquées. Pour obtenir la liste complète des réponses d'erreur, consultez Réponses d'erreur.
- Chaque requête consomme du 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 consultée 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 à envoyer 120 requêtes potentiellement soumises à un seuil par heure. Les dimensions userAgeBracket, userGender, brandingInterest, audienceId et audienceName peuvent être 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 utilisés à chaque requête envoyée à l'API Google Analytics Data v1.
Le nombre de jetons facturés dépend de la complexité de la requête. La plupart des requêtes consomment 10 jetons ou moins, mais les requêtes plus complexes (comme les requêtes chat de l'assistant Analytics) en consomment davantage.
Facteurs qui influencent la consommation de jetons
Le coût exact en jetons d'une requête est déterminé au moment de l'exécution, ce qui rend difficile le précalcul précis. Le coût dépend d'une combinaison de facteurs liés à la requête elle-même et aux données sous-jacentes de la propriété Google Analytics. Les facteurs suivants peuvent entraîner des coûts plus élevés :
- Nombre de lignes : vous demandez un plus grand nombre de lignes.
- Nombre de dimensions et de métriques : incluez un plus grand nombre de dimensions et de métriques.
- Complexité des filtres : utilisation d'expressions de filtre complexes.
- Durée de la période : requêtes sur des périodes plus longues.
- Cardinalité des données : les dimensions à cardinalité élevée (nombreuses valeurs uniques, comme
pagePath, les dimensions personnalisées) peuvent augmenter considérablement le coût en jetons. - Volume d'événements de la propriété : les requêtes sur les 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.
Surveiller l'utilisation des jetons
Le moyen le plus efficace de déterminer le coût en jetons de 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 inclura alors l'objet PropertyQuota, qui détaille les jetons consommés par cette requête spécifique et les soldes de quota restants.
Consommation et surveillance des jetons de chat
Pour les requêtes chat de l'assistant Analytics, les jetons représentent les coûts de calcul, de raisonnement et de récupération des données sous-jacentes du modèle. La consommation de jetons de chat est influencée par :
- Champ d'application de la requête et de l'analyse : complexité et étendue de l'analyse demandée.
- Jetons d'entrée et de sortie du modèle : volume de données contextuelles traitées et récit de réponse généré.
- Jetons de réflexion : étapes de raisonnement du modèle requises pour synthétiser les résultats.
- Latence d'exécution : temps de traitement requis pour les explorations de données en plusieurs étapes.
Pour surveiller l'utilisation des jetons de chat, définissez "returnPropertyQuota": true dans votre ChatRequest. La réponse inclura l'objet PropertyChatQuota contenant les champs tokensPerDay et tokensPerHour avec les soldes consommés et restants.