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 trois catégories de quotas de requêtes : "Core", "Realtime" et "Funnel". 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. 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és Analytics 360 |
|---|---|---|
| Jetons Core 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 d'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 |
| Nombre de requêtes simultanées dans l'entonnoir par propriété | 10 | 50 |
| Erreurs de serveur de l'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 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 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é depuis le projet sont bloquées.
- Chaque requête consomme des jetons pour les quotas "Jetons par propriété et par heure" et "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 calculés à chaque requête en fonction de la complexité de celle-ci. La plupart des requêtes consomment 10 jetons ou moins. Lorsqu'une requête consomme un grand nombre de jetons de quota, les facteurs suivants sont souvent en cause :
- Nombre de lignes élevé
- Nombre de colonnes élevé
- Critères de filtrage complexes
- Plage de dates étendue
Pour chaque requête d'API, vous pouvez spécifier "returnPropertyQuota": true dans le corps de la requête afin de renvoyer l'état actuel des jetons de quota de propriété. Cet état contient à la fois la quantité consommée par cette requête et la quantité restante pour chaque groupe de quotas. Par exemple, envisagez de spécifier ce paramètre dans RunReportRequest.