Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Các hạn mức và hạn mức sau đây áp dụng cho Data API.
Danh mục hạn mức
Data API có 3 danh mục hạn mức yêu cầu: Lõi, Theo thời gian thực và Phễu. Các yêu cầu API đến các phương thức Core sẽ tính phí hạn mức Core. Các yêu cầu API đến phương thức Realtime sẽ tính hạn mức Realtime. Mỗi yêu cầu chỉ sử dụng một loại hạn mức.
Số mã thông báo cốt lõi trên mỗi dự án, trên mỗi tài sản, mỗi giờ
14.000
140.000
Số yêu cầu đồng thời cốt lõi trên mỗi tài sản
10
50
Số lỗi máy chủ cốt lõi trên mỗi dự án, mỗi tài sản mỗi giờ
10
50
Số mã thông báo theo thời gian thực trên mỗi tài sản mỗi ngày
200.000
2.000.000
Số mã thông báo theo thời gian thực trên mỗi tài sản mỗi giờ
40.000
400.000
Số mã thông báo theo thời gian thực trên mỗi dự án, trên mỗi tài sản, mỗi giờ
14.000
140.000
Số yêu cầu đồng thời theo thời gian thực trên mỗi tài sản
10
50
Lỗi máy chủ theo thời gian thực trên mỗi dự án, mỗi tài sản, mỗi giờ
10
50
Số mã thông báo phễu trên mỗi tài sản mỗi ngày
200.000
2.000.000
Số mã thông báo phễu trên mỗi tài sản mỗi giờ
40.000
400.000
Số mã thông báo phễu trên mỗi dự án trên mỗi tài sản mỗi giờ
14.000
140.000
Số yêu cầu đồng thời trên phễu trên mỗi tài sản
10
50
Số lỗi máy chủ phễu trên mỗi dự án, trên mỗi tài sản, mỗi giờ
10
50
Số yêu cầu đồng thời được đo lường bằng số lượng yêu cầu đang được thực thi đồng thời. Để giảm số lượng yêu cầu đồng thời, hãy đợi các yêu cầu trước đó hoàn tất trước khi gửi các yêu cầu khác.
Lỗi máy chủ là mã 500 và 503. Hạn mức lỗi máy chủ chỉ bị tính phí khi một yêu cầu dẫn đến lỗi máy chủ. Khi hạn mức Lỗi máy chủ đã dùng hết cho một cặp dự án và tài sản, tất cả các yêu cầu đến tài sản từ dự án sẽ bị chặn.
Mỗi yêu cầu sẽ sử dụng hạn mức cho cả Mã thông báo mỗi tài sản mỗi giờ và Mã thông báo mỗi dự án mỗi tài sản mỗi giờ. Điều này có nghĩa là một tài sản phải được nhiều hơn 3 dự án truy cập thì hạn mức "Mã thông báo trên mỗi tài sản mỗi giờ" mới có thể hết trước hạn mức "Mã thông báo trên mỗi dự án trên mỗi tài sản mỗi giờ".
Mỗi giờ, tài sản được phép gửi 120 yêu cầu có thể đạt đến ngưỡng. Các phương diện userAgeBracket, userGender, brandingInterest, audienceId và audienceName có thể được đặt ngưỡng. Chúng tôi dùng ngưỡng dữ liệu để không ai có thể suy luận ra thông tin nhân khẩu học hoặc mối quan tâm của người dùng trong khi xem báo cáo.
Hạn mức mã thông báo tài sản
Mã thông báo được tính cho mỗi yêu cầu tuỳ thuộc vào độ phức tạp của yêu cầu.
Hầu hết các yêu cầu sẽ tính phí 10 mã thông báo trở xuống. Khi một yêu cầu tiêu thụ một lượng lớn mã thông báo hạn mức, các yếu tố sau đây thường là nguyên nhân:
Số lượng hàng lớn
Số lượng cột lớn
Tiêu chí lọc phức tạp
Phạm vi ngày dài
Với mỗi yêu cầu API, bạn có thể chỉ định "returnPropertyQuota": true trong phần nội dung yêu cầu để trả về trạng thái mã thông báo hạn mức tài sản hiện tại. Trạng thái này chứa cả số lượng mà yêu cầu này đã sử dụng và số lượng còn lại cho mỗi nhóm hạn mức. Ví dụ: hãy xem xét việc chỉ định tham số này trong RunReportRequest.
[null,null,["Cập nhật lần gần đây nhất: 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)."]]
