Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
All'API Data si applicano i seguenti limiti e quote.
Categorie di quote
L'API di dati ha tre categorie di quote per le richieste: Core,
in tempo reale e canalizzazione. Le richieste API ai metodi di base addebitano quote di base. Le richieste API ai metodi in tempo reale comportano l'addebito delle quote in tempo reale. Ogni richiesta utilizza solo un tipo di quota.
Tutte le richieste consumano le quote della proprietà.
Nome quota
Limite di proprietà standard
Limite di proprietà Analytics 360
Token principali per proprietà al giorno
200.000
2.000.000
Token core per proprietà all'ora
40.000
400.000
Token di core per progetto, per proprietà, all'ora
14.000
140.000
Richieste in parallelo principali per proprietà
10
50
Errori del server principale per progetto, per proprietà e per ora
10
50
Token in tempo reale per proprietà al giorno
200.000
2.000.000
Token in tempo reale per proprietà all'ora
40.000
400.000
Token in tempo reale per progetto, per proprietà, all'ora
14.000
140.000
Richieste in tempo reale in parallelo per proprietà
10
50
Errori del server in tempo reale per progetto, per proprietà e per ora
10
50
Token canalizzazione per proprietà al giorno
200.000
2.000.000
Token canalizzazione per proprietà all'ora
40.000
400.000
Token canalizzazione per progetto, per proprietà, all'ora
14.000
140.000
Richieste in parallelo della canalizzazione per proprietà
10
50
Errori del server della canalizzazione per progetto, per proprietà e per ora
10
50
Le richieste in parallelo vengono misurate in base al numero di richieste eseguite contemporaneamente. Per ridurre la concorrenza delle richieste, attendi il completamento delle richieste precedenti prima di inviare richieste aggiuntive.
Gli errori del server sono i codici 500 e 503. Le quote per gli errori del server vengono addebitate solo quando una richiesta genera un errore del server. Quando le quote relative agli errori del server sono esaurite per una coppia di progetti e proprietà, tutte le richieste alla proprietà dal progetto vengono bloccate.
Ogni richiesta consuma la quota sia per i token per proprietà all'ora sia per i token per progetto per proprietà all'ora. Ciò significa che una proprietà deve essere acceduta da più di 3 progetti prima che la quota "Token per proprietà per ora" possa essere esaurita prima della quota "Token per progetto per proprietà per ora".
Le proprietà sono autorizzate a inviare 120 richieste con soglia potenziale all'ora. Le dimensioni userAgeBracket, userGender, brandingInterest, audienceId e audienceName sono potenzialmente con soglia. Le soglie vengono applicate per impedire a chiunque visualizzi un report di dedurre i dati demografici o gli interessi dei singoli utenti.
Quota di token della proprietà
I token vengono calcolati con ogni richiesta, a seconda della complessità della richiesta.
La maggior parte delle richieste prevede l'addebito di massimo 10 token. Quando una richiesta consuma un numero elevato di token di quota, spesso la causa è uno dei seguenti fattori:
Numero elevato di righe
Numero elevato di colonne
Criteri di filtro complessi
Intervallo di date lungo
Con ogni richiesta API, puoi specificare "returnPropertyQuota": true nel corpo della richiesta per restituire lo stato corrente dei token di quota della proprietà. Questo stato contiene sia la quantità utilizzata da questa richiesta sia la quantità rimanente per ogni gruppo di quota. Ad esempio, puoi specificare questo parametro in
RunReportRequest.
[null,null,["Ultimo aggiornamento 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)."]]
