Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les limites et quotas suivants s'appliquent à l'API Data.
Catégories de quotas
L'API Data comporte trois catégories de quotas de requêtes : "Core", "Realtime" et "Funnel". Les requêtes API vers les méthodes Core sont facturées en quotas Core. Les requêtes API aux méthodes en temps réel facturent des quotas en temps réel. Chaque requête ne consomme qu'un seul type de quota.
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
Nombre de jetons de cœur par propriété et par jour
200 000
2 000 000
Nombre de 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 de base 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
Nombre d'erreurs de serveur en temps réel par projet et par propriété, 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 de l'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 du serveur d'entonnoir par projet et par propriété, 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 codes 500 et 503 correspondent à des erreurs de serveur. 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 de projet et de propriété, toutes les requêtes envoyées à la propriété à partir du projet sont bloquées.
Chaque requête consomme des quotas pour les jetons par établissement et par heure, ainsi que pour les jetons par projet et par établissement et par heure. Cela signifie qu'une propriété doit être accessible par plus de trois projets pour que le quota de jetons par propriété et par heure puisse être épuisé avant le quota de jetons par projet et 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 sont potentiellement soumises à un seuil. 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 pour chaque requête en fonction de sa complexité.
La plupart des requêtes ne consomment que 10 jetons ou moins. Lorsqu'un grand nombre de jetons de quota sont consommés par une requête, les facteurs suivants sont souvent responsables:
Nombre élevé de lignes
Nombre élevé de colonnes
Critères de filtrage complexes
Plage de dates longue
Pour 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 propriété. Cet état contient à la fois la quantité consommée par cette requête et la quantité restante pour chaque groupe de quota. Par exemple, vous pouvez spécifier ce paramètre dans RunReportRequest.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (UTC)."],[[["\u003cp\u003eThe Google Analytics Data API uses a quota system to limit the number of requests and resources consumed, categorized into Core, Realtime, and Funnel based on the API methods used.\u003c/p\u003e\n"],["\u003cp\u003eEach request to the API consumes tokens and is subject to daily and hourly quotas, with separate limits for standard and Analytics 360 properties.\u003c/p\u003e\n"],["\u003cp\u003eExceeding any quota results in request failures with error messages, emphasizing the importance of managing request concurrency and minimizing server errors.\u003c/p\u003e\n"],["\u003cp\u003eThe token cost for each request varies depending on the request complexity, with factors like data volume, filtering, and date ranges significantly influencing token consumption.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can monitor quota usage by including \u003ccode\u003e"returnPropertyQuota": true\u003c/code\u003e in the request body to receive the current token status and remaining quota.\u003c/p\u003e\n"]]],["API requests consume quotas, categorized as Core, Realtime, or Funnel. Each request verifies and consumes quota within its category, failing if exhausted. Quotas include tokens per property, project, and concurrent requests, with different limits for standard and Analytics 360 properties. Server errors also have quotas, blocking requests upon exhaustion. Token consumption varies based on request complexity (rows, columns, filters, date ranges). Each request can check its quota status. Potentially thresholded data can also affect the result of the request.\n"],null,["# Data API limits and quotas\n\nThe following limits and quotas apply to the Data API.\n\nQuota Categories\n----------------\n\nThe Data API has three request quota categories: Core,\nRealtime, and Funnel. API requests to Core methods charge Core quotas. API\nrequests to Realtime methods charge Realtime quotas. Each request consumes only\none kind of quota.\n\n| Quota Category | API Methods |\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Core | [runReport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport), [runPivotReport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runPivotReport), [batchRunReports](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunReports), [batchRunPivotReports](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/batchRunPivotReports), [runAccessReport](/analytics/devguides/config/admin/v1/rest/v1alpha/properties/runAccessReport), [getMetadata](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/getMetadata), [checkCompatibility](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/checkCompatibility), [createAudienceExports](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create) |\n| Realtime | [runRealtimeReport](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runRealtimeReport) |\n| Funnel | [runFunnelReport](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runFunnelReport) |\n\nAnalytics Property Quotas\n-------------------------\n\nAll requests consume property quotas.\n\n| Quota Name | Standard Property Limit | Analytics 360 Property Limit |\n|----------------------------------------------------------|-------------------------|------------------------------|\n| Core Tokens Per Property Per Day | 200,000 | 2,000,000 |\n| Core Tokens Per Property Per Hour | 40,000 | 400,000 |\n| Core Tokens Per Project Per Property Per Hour | 14,000 | 140,000 |\n| Core Concurrent Requests Per Property | 10 | 50 |\n| Core Server Errors Per Project Per Property Per Hour | 10 | 50 |\n| Realtime Tokens Per Property Per Day | 200,000 | 2,000,000 |\n| Realtime Tokens Per Property Per Hour | 40,000 | 400,000 |\n| Realtime Tokens Per Project Per Property Per Hour | 14,000 | 140,000 |\n| Realtime Concurrent Requests Per Property | 10 | 50 |\n| Realtime Server Errors Per Project Per Property Per Hour | 10 | 50 |\n| Funnel Tokens Per Property Per Day | 200,000 | 2,000,000 |\n| Funnel Tokens Per Property Per Hour | 40,000 | 400,000 |\n| Funnel Tokens Per Project Per Property Per Hour | 14,000 | 140,000 |\n| Funnel Concurrent Requests Per Property | 10 | 50 |\n| Funnel Server Errors Per Project Per Property Per Hour | 10 | 50 |\n\n- Concurrent requests are measured by the number of requests being simultaneously executed. To reduce your request concurrency, wait for previous requests to complete before sending additional requests.\n- Server Errors are 500 and 503 codes. Server Errors quotas are only charged when a request results in a server error. When the Server Errors quotas are exhausted for a project and property pair, all requests to the property from the project are blocked.\n- Each request consumes quota for both Tokens Per Property Per Hour and Tokens Per Project Per Property Per Hour. This means that one property must be accessed by more than 3 projects before the \"Tokens Per Property Per Hour\" quota could be exhausted before the \"Tokens Per Project Per Property Per Hour\" quota.\n\n| **Note:** All daily quotas are refreshed at midnight Pacific Standard Time. All hourly quotas are refreshed within an hour but not necessarily on the whole hour boundaries.\n\nProperties are allowed 120 potentially thresholded requests per hour. The\ndimensions `userAgeBracket`, `userGender`, `brandingInterest`, `audienceId`, and\n`audienceName` are potentially thresholded. Thresholds are applied to prevent\nanyone viewing a report from inferring the demographics or interests of\nindividual users.\n\n### Property Tokens Quota\n\nTokens are calculated with each request depending upon the request's complexity.\nMost requests will charge 10 or fewer tokens. When a large number\nof quota tokens are consumed by a request, these factors are often responsible:\n\n- Large number of rows\n- Large number of columns\n- Complex filter criteria\n- Long date range\n\nWith each API request, you can specify `\"returnPropertyQuota\": true` in the\nrequest body to return the current property quota tokens status. This status\ncontains both the amount consumed by this request and the amount remaining for\neach quota group. For example, consider specifying this parameter in\n[`RunReportRequest`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport#request-body)."]]
