با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
محدودیت ها و سهمیه های زیر برای Data API اعمال می شود.
دسته بندی سهمیه
Data API دارای سه دسته سهمیه درخواست است: Core، Realtime، و Funnel. درخواست‌های API به روش‌های Core سهمیه‌های Core را شارژ می‌کنند. درخواست‌های API به روش‌های Realtime سهمیه Realtime را شارژ می‌کنند. هر درخواست فقط یک نوع سهمیه را مصرف می کند.
خطاهای سرور بلادرنگ در هر پروژه در هر ویژگی در ساعت
10
50
قیف توکن در هر ملک در روز
200000
2,000,000
قیف توکن در هر ملک در ساعت
40000
400000
توکن های قیف در هر پروژه در هر ملک در ساعت
14000
140000
قیف درخواست های همزمان برای هر ملک
10
50
خطاهای سرور قیف در هر پروژه در هر ویژگی در ساعت
10
50
درخواست های همزمان با تعداد درخواست هایی که به طور همزمان اجرا می شوند اندازه گیری می شوند. برای کاهش همزمانی درخواست خود، قبل از ارسال درخواست‌های اضافی منتظر بمانید تا درخواست‌های قبلی تکمیل شوند.
خطاهای سرور کدهای 500 و 503 هستند. سهمیه خطاهای سرور فقط زمانی محاسبه می شود که درخواست منجر به خطای سرور شود. هنگامی که سهمیه خطاهای سرور برای یک جفت پروژه و دارایی تمام می شود، تمام درخواست های پروژه به ویژگی مسدود می شود.
هر درخواست سهمیه ای برای هر دو توکن در هر ملک در ساعت و توکن در هر پروژه در هر ملک در ساعت مصرف می کند. این به این معنی است که قبل از اتمام سهمیه "Tokens Per Property Per Hour" قبل از "Tokens Per Project Per Property Per Hour" سهمیه "Tokens Per Project Per Property Per Hour" به بیش از 3 پروژه باید دسترسی داشته باشد.
اموال مجاز به 120 درخواست آستانه بالقوه در هر ساعت هستند. ابعاد userAgeBracket ، userGender ، brandingInterest ، audienceId ، و audienceName به طور بالقوه دارای آستانه هستند. آستانه‌ها برای جلوگیری از استنباط اطلاعات جمعیتی یا علائق کاربران فردی که گزارشی را مشاهده می‌کنند، اعمال می‌شوند.
سهمیه نمادهای املاک
توکن ها با هر درخواست بسته به پیچیدگی درخواست محاسبه می شوند. اکثر درخواست ها 10 توکن یا کمتر را شارژ می کنند. هنگامی که تعداد زیادی از توکن های سهمیه توسط یک درخواست مصرف می شود، این عوامل اغلب مسئول هستند:
تعداد ردیف زیاد
تعداد زیادی ستون
معیارهای فیلتر پیچیده
محدوده تاریخ طولانی
با هر درخواست API، می‌توانید "returnPropertyQuota": true در بدنه درخواست برای بازگرداندن وضعیت فعلی سهمیه ویژگی‌ها. این وضعیت هم مقدار مصرف شده توسط این درخواست و هم مقدار باقی مانده برای هر گروه سهمیه را شامل می شود. برای مثال، مشخص کردن این پارامتر را در RunReportRequest در نظر بگیرید.
،
محدودیت ها و سهمیه های زیر برای Data API اعمال می شود.
دسته بندی سهمیه
Data API دارای سه دسته سهمیه درخواست است: Core، Realtime، و Funnel. درخواست‌های API به روش‌های Core سهمیه‌های Core را شارژ می‌کنند. درخواست‌های API به روش‌های Realtime سهمیه Realtime را شارژ می‌کنند. هر درخواست فقط یک نوع سهمیه را مصرف می کند.
خطاهای سرور بلادرنگ در هر پروژه در هر ویژگی در ساعت
10
50
قیف توکن در هر ملک در روز
200000
2,000,000
قیف توکن در هر ملک در ساعت
40000
400000
توکن های قیف در هر پروژه در هر ملک در ساعت
14000
140000
قیف درخواست های همزمان برای هر ملک
10
50
خطاهای سرور قیف در هر پروژه در هر ویژگی در ساعت
10
50
درخواست های همزمان با تعداد درخواست هایی که به طور همزمان اجرا می شوند اندازه گیری می شوند. برای کاهش همزمانی درخواست خود، قبل از ارسال درخواست‌های اضافی منتظر بمانید تا درخواست‌های قبلی تکمیل شوند.
خطاهای سرور کدهای 500 و 503 هستند. سهمیه خطاهای سرور فقط زمانی محاسبه می شود که درخواست منجر به خطای سرور شود. هنگامی که سهمیه خطاهای سرور برای یک جفت پروژه و دارایی تمام می شود، تمام درخواست های پروژه به ویژگی مسدود می شود.
هر درخواست سهمیه ای برای هر دو توکن در هر ملک در ساعت و توکن در هر پروژه در هر ملک در ساعت مصرف می کند. این به این معنی است که قبل از اتمام سهمیه "Tokens Per Property Per Hour" قبل از "Tokens Per Project Per Property Per Hour" سهمیه "Tokens Per Project Per Property Per Hour" به بیش از 3 پروژه باید دسترسی داشته باشد.
اموال مجاز به 120 درخواست آستانه بالقوه در هر ساعت هستند. ابعاد userAgeBracket ، userGender ، brandingInterest ، audienceId ، و audienceName به طور بالقوه دارای آستانه هستند. آستانه‌ها برای جلوگیری از استنباط اطلاعات جمعیتی یا علائق کاربران فردی که گزارشی را مشاهده می‌کنند، اعمال می‌شوند.
سهمیه توکن های املاک
توکن ها با هر درخواست بسته به پیچیدگی درخواست محاسبه می شوند. اکثر درخواست ها 10 توکن یا کمتر را شارژ می کنند. هنگامی که تعداد زیادی از توکن های سهمیه توسط یک درخواست مصرف می شود، این عوامل اغلب مسئول هستند:
تعداد ردیف زیاد
تعداد زیادی ستون
معیارهای فیلتر پیچیده
محدوده تاریخ طولانی
با هر درخواست API، می‌توانید "returnPropertyQuota": true در بدنه درخواست برای بازگرداندن وضعیت فعلی سهمیه ویژگی‌ها. این وضعیت هم مقدار مصرف شده توسط این درخواست و هم مقدار باقی مانده برای هر گروه سهمیه را شامل می شود. برای مثال، مشخص کردن این پارامتر را در RunReportRequest در نظر بگیرید.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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)."]]
