Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Os limites e cotas a seguir se aplicam à API Data.
Categorias de cota
A API Data tem três categorias de cota de solicitação: principal, de tempo real e funil. As solicitações de API para métodos do Core cobram cotas do Core. As solicitações de API para métodos de tempo real cobram cotas de tempo real. Cada solicitação consome apenas
um tipo de cota.
Todas as solicitações consomem cotas da propriedade.
Nome da cota
Limite de propriedade padrão
Limite de propriedades do Google Analytics 360
Tokens principais por propriedade e dia
200.000
2.000.000
Tokens de núcleo por propriedade e hora
40.000
400.000
Tokens de núcleo por projeto, propriedade e hora
14.000
140.000
Solicitações simultâneas principais por propriedade
10
50
Erros de servidor principais por projeto, propriedade e hora
10
50
Tokens em tempo real por propriedade e dia
200.000
2.000.000
Tokens em tempo real por propriedade e hora
40.000
400.000
Tokens em tempo real por projeto, propriedade e hora
14.000
140.000
Solicitações simultâneas em tempo real por propriedade
10
50
Erros de servidor em tempo real por projeto, propriedade e hora
10
50
Tokens de funil por propriedade e dia
200.000
2.000.000
Tokens de funil por propriedade e hora
40.000
400.000
Tokens do funil por projeto, propriedade e hora
14.000
140.000
Solicitações simultâneas por funil por propriedade
10
50
Erros de servidor do funil por projeto, propriedade e hora
10
50
As solicitações simultâneas são medidas pelo número de solicitações
executadas ao mesmo tempo. Para reduzir a simultaneidade de solicitações, aguarde
a conclusão das solicitações anteriores antes de enviar outras.
Os erros do servidor são os códigos 500 e 503. As cotas de erros do servidor só são cobradas
quando uma solicitação resulta em um erro do servidor. Quando as cotas de erros de servidor são
esgotadas para um par de projeto e propriedade, todas as solicitações para a propriedade
do projeto são bloqueadas.
Cada solicitação consome a cota de tokens por propriedade e hora e de tokens por projeto, propriedade e hora. Isso significa que uma propriedade precisa ser acessada por mais de três projetos antes que a cota de "Tokens por propriedade e hora" seja esgotada antes da cota de "Tokens por projeto e hora".
As propriedades podem fazer 120 solicitações com possível limitação por hora. As
dimensões userAgeBracket, userGender, brandingInterest, audienceId e
audienceName têm um limite mínimo. Os limites são aplicados para impedir que alguém que visualiza um relatório infira as informações demográficas ou interesses de usuários individuais.
Cota de tokens de propriedade
Os tokens são calculados com cada solicitação, dependendo da complexidade dela.
A maioria das solicitações vai cobrar 10 tokens ou menos. Quando um grande número de tokens de cota é consumido por uma solicitação, esses fatores geralmente são responsáveis:
Grande número de linhas
Grande número de colunas
Critérios de filtro complexos
Período longo
Com cada solicitação de API, é possível especificar "returnPropertyQuota": true no
corpo da solicitação para retornar o status atual dos tokens de cota da propriedade. Esse status
contém o valor consumido por essa solicitação e o valor restante para
cada grupo de cota. Por exemplo, considere especificar esse parâmetro em
RunReportRequest.
[null,null,["Última atualização 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)."]]
