الحدود والحصص المفروضة على طلبات البيانات من واجهة برمجة التطبيقات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لضمان عدم تلقّي نظام "إحصاءات Google" لبيانات أكثر مما يمكنه التعامل معه، ولضمان التوزيع العادل لموارد النظام على جميع المستخدمين، تفرض واجهات برمجة تطبيقات "إحصاءات Google" بعض الحدود والحصص على استخدامك.
تنطبق الحدود والحصص التالية على إجمالي استخدام Google Analytics API
(باستثناء طلبات Data API) على مستوى مشروع Google Cloud:
50,000 طلب لكل مشروع في اليوم
10 طلبات بحث في الثانية لكل عنوان IP
في وحدة تحكّم واجهة برمجة التطبيقات، تتوفّر حصة مماثلة تتمثّل في الطلبات لكل 100 ثانية لكل مستخدم. يتم تلقائيًا
ضبطه على 100 طلب كل 100 ثانية لكل مستخدم، ويمكن تعديله ليصل إلى
الحد الأقصى الذي يبلغ 1,000. ولكن يتم تحديد عدد الطلبات المرسَلة إلى واجهة برمجة التطبيقات
بحد أقصى 10 طلبات في الثانية لكل مستخدم.
إذا كان تطبيقك يُجري جميع طلبات واجهة برمجة التطبيقات من عنوان IP واحد (مثلاً، بالنيابة عن المستخدمين)، استخدِم المَعلمة userIP أو quotaUser
مع كل طلب للحصول على الحصة الكاملة من عدد طلبات البحث في الثانية لكل مستخدم. اطّلِع على ملخّص مَعلمات طلبات البحث العادية للحصول على التفاصيل.
تفرض بعض واجهات برمجة التطبيقات قيودًا إضافية. لمعرفة التفاصيل حول الحدود القصوى ومقدّرات المساحة التخزينية الخاصة بواجهة برمجة التطبيقات، يُرجى الاطّلاع على الصفحات التالية:
إذا تم تجاوز الحصة المسموح بها لطلب Google Analytics API، ستعرض واجهة برمجة التطبيقات
رمز الخطأ 403 أو 429 ورسالة تفيد بأنّ الحساب تجاوز
الحصة المسموح بها. يُرجى الاطّلاع على بنود الخدمة للحصول على مزيد من المعلومات.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Limits and quotas on API requests\n\nTo ensure the Google Analytics system doesn't receive more data than it can\nhandle, and to ensure equitable distribution of the system's resources across\nusers, Google Analytics APIs enfore some limits and quotas on your usage. \n\nThe following limits and quotas apply to your overall Google Analytics API usage\n(excluding Data API calls) at the Google Cloud project level:\n\n- 50,000 requests per *project* per day.\n- 10 queries per second (QPS) per *IP address* .\n - In the [API Console](https://console.cloud.google.com/), there is a similar quota referred to as *Requests per 100 seconds per user*. By default, it is set to 100 requests per 100 seconds per user and can be adjusted to a maximum value of 1,000. But the number of requests to the API is restricted to a maximum of 10 requests per second per user.\n - If your application makes all API requests from a single IP address (for example, on behalf of your users), use the `userIP` or `quotaUser` parameter with each request to get full QPS quota for each user. See The [standard query parameters summary](/analytics/devguides/parameters) for details.\n\n| **Note:** Daily quotas are refreshed at midnight Pacific Standard Time.\n\nSome APIs have additional restrictions. For details on API-specific limits and\nquotas, see the following pages:\n\n- [Admin API](/analytics/devguides/config/admin/v1/quotas)\n- [Data API](/analytics/devguides/reporting/data/v1/quotas)\n- [User Deletion API](/analytics/devguides/config/userdeletion/v3/limits-quotas)\n\nErrors related to limits and quotas\n-----------------------------------\n\nIf the quota of requesting a Google Analytics API is exceeded, the API returns\nan error code `403` or `429` and a message that the account has exceeded the\nquota. See the [terms of service](/terms) for more information.\n\nFor more information on quota management and how to fine-tune your application\nfor quota usage, see [Monitoring APIs and capping\nusage](https://support.google.com/cloud/answer/6158858)."]]
