Chaque requête API vérifie que les quotas n'ont pas été épuisés et consomme des quotas. Si un quota est épuisé, la requête échoue et un message d'erreur s'affiche. Chaque requête Data API vérifie plusieurs buckets de quota.
Catégories de quota
Pour les besoins des quotas, l'API Data comporte trois catégories de requêtes: principales, en temps réel et entonnoir. Les requêtes API envoyées aux méthodes Core facturent des quotas Core. Les requêtes API envoyées aux méthodes Realtime facturent des quotas en temps réel. Une requête ne consommera pas à la fois les quotas principaux et en temps réel. Voici les méthodes et catégories de l'API:
| Catégorie de quota | Méthodes d'API |
|---|---|
| Éléments de base | runReport, runPivotReport, batchRunReports, batchRunPivotReports, runAccessReport, getMetadata, checkCompatibility et createAudienceExports |
| Temps réel | runRealtimeReport |
| Entonnoir | runFunnelReport |
Quotas associés aux 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 de cœur par propriété et par jour | 200 000 | 2 000 000 |
| Jetons de cœur par propriété et par heure | 40 000 | 400 000 |
| Jetons de cœur par projet, par propriété et par heure | 14 000 | 140,000 |
| Requêtes simultanées principales par propriété | 10 | 50 |
| Erreurs du serveur principal 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 |
| 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 |
| Demandes simultanées par propriété dans l'entonnoir | 10 | 50 |
| Erreurs de serveur dans 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 simultanément. Pour réduire la simultanéité de vos 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 serveur ne sont facturés que lorsqu'une requête "Erreur serveur" est envoyée. 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é provenant du projet sont bloquées.
- Chaque requête consomme un quota de jetons par propriété et par heure et de jetons par projet, par propriété et par heure. Cela signifie qu'une propriété doit être accessible par plus de trois projets avant que le quota "Jetons par propriété et par heure" ne puisse être épuisé avant que le quota "Jetons par projet, par propriété et par heure" ne soit épuisé.
Les propriétés sont autorisées à atteindre 120 requêtes potentiellement soumises à un seuil par heure. Les dimensions userAgeBracket, userGender, brandingInterest, audienceId et audienceName sont potentiellement soumises à un seuil. Les seuils permettent d'empêcher toute personne qui consulte un rapport de 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 avec chaque requête en fonction de sa complexité. La plupart des requêtes facturent 10 jetons ou moins. Lorsqu'une requête consomme un grand nombre de jetons de quota, les facteurs suivants sont souvent responsables:
- Un grand nombre de lignes
- Un grand nombre de colonnes
- Critères de filtre complexes
- Longue période
Avec chaque requête API, vous pouvez spécifier "returnPropertyQuota": true dans le corps de la requête pour renvoyer l'état actuel des jetons de quota de la 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.