حدود وحصص واجهة برمجة التطبيقات في "إدارة العلامات من Google"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يوضِّح هذا المستند الحدود والحصص لواجهة Google Tag Manager API.
نظرة عامة
تستخدم ملايين المواقع الإلكترونية أداة "إدارة العلامات من Google". لحماية النظام من
تلقّي بيانات أكثر مما يمكنه التعامل معه، وضمان التوزيع العادل لموارد النظام، تم وضع حدود معيّنة. في ما يلي
سياساتنا وهي عرضة للتغيير.
جارٍ الحصول على الحصة
يجب أن تسجِّل تطبيقك في وحدة التحكم في واجهة Google API للحصول على أي حصة، ولن يُسمح
بحصة غير مسجّلة. عند تسجيل تطبيق جديد، يتم منحك معرّف عميل فريدًا لتحديد كل تطبيق ضمن هذا المشروع.
اقرأ قسم المفاتيح وإمكانية الوصول والأمان والهوية في دليل وحدة تحكّم واجهة برمجة التطبيقات للاطّلاع على مزيد من المعلومات حول كيفية تعرُّف معرّفات
العملاء على التطبيقات.
حدود الحصص العامة
تنطبق حدود الحصة التالية على جميع الطلبات التي يتم إرسالها إلى Tag Manager API:
10,000 طلب لكل مشروع في اليوم.
0.25 طلب في الثانية (QPS) لكل مشروع.
تكون هذه الحصص مستقلة عن الحصص التي يمكنك ضبطها في وحدة تحكم واجهة برمجة التطبيقات. إذا
ضبطت الحد الأقصى لكل مستخدم للمشروع على 0.25 طلب في الثانية،
فإن سياسة الحصة في أداة "إدارة العلامات من Google" سارية وستقوم بتقييد الطلبات لكل مشروع
إلى 0.25 طلب في الثانية.
تجاوز حدود الحصص
في حال تجاوز الحصة، تعرض واجهة برمجة تطبيقات "إدارة العلامات من Google" رسالة خطأ
للطلبات الإضافية: رمز حالة HTTP 403 Forbidden
ورسالة تشير إلى عدم توفّر حصة كافية
في الحساب المحدّد للمتابعة.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGoogle Tag Manager API usage is subject to limits and quotas to ensure system stability and fair resource allocation.\u003c/p\u003e\n"],["\u003cp\u003eAll applications must be registered in the Google API Console to receive quota and obtain a unique client ID.\u003c/p\u003e\n"],["\u003cp\u003eGeneral quota limits include 10,000 requests per project per day and 0.25 queries per second (QPS) per project.\u003c/p\u003e\n"],["\u003cp\u003eExceeding quota limits results in a \u003ccode\u003e403 Forbidden\u003c/code\u003e error, but higher quotas can be requested through the API Console.\u003c/p\u003e\n"]]],["The Google Tag Manager API enforces quota limits to manage system resources. Every application must be registered in the Google API Console to receive quota. Limits are set at 10,000 requests per project daily and 0.25 queries per second (QPS) per project, enforced independently of console settings. Exceeding quotas results in a `403 Forbidden` error. Daily quotas refresh at midnight PST, and QPS is measured in a 100 second window. An increase in quota can be requested in the API Console.\n"],null,["# Tag Manager API Limits and Quotas\n\nThis document describes the limits and quotas for the Google Tag Manager API.\n\nOverview\n--------\n\nGoogle Tag Manager is used by millions of sites. To protect the system from\nreceiving more data than it can handle, and to ensure an equitable\ndistribution of system resources, certain limits have been put in place. Our\npolicies are as follows and are subject to change.\n\nObtaining Quota\n---------------\n\nYou must register your application in the\n[Google API Console](https://console.cloud.google.com/) to receive any quota; no\nunregistered quota will be allowed. When you register a new application, you\nare given a unique client ID to identify each application under that project.\nRead the [Keys, access, security, and\nidentity](/console/help/using-keys)\nsection of the API Console guide to learn more about how client\nIDs identify applications.\n\n### General Quota Limits\n\nThe following quota limits apply to all requests made to the\n[Tag Manager API](/tag-platform/tag-manager/api/v2):\n\n- 10,000 requests per **project** per day.\n- 0.25 queries per second (QPS) per **project**.\n\nThese quotas are independent of those you can set in the\n[API Console](https://console.cloud.google.com/). If the\nyou set the project's **per-user limit** above 0.25 QPS, the\nGoogle Tag Manager quota policy will still take effect and limit per-project\nrequests to 0.25 QPS.\n| **Note**: Daily quotas refresh at midnight PST. QPS quotas are enforced on a 100 second sliding window (i.e. 25 requests per 100 seconds).\n\nExceeding Quota Limits\n----------------------\n\nIf quota is exceeded, Google Tag Manager API returns an error for\nadditional requests: HTTP status code `403 Forbidden` and\na message indicating that the specific account has insufficient\nquota to proceed.\n| **Note** : You can apply for an increased quota by clicking **Edit Quotas** in the [API Console](https://console.cloud.google.com/) and filling out the *apply for higher quota form* to have your request considered."]]
