الحدود والحصص في طلبات واجهة برمجة التطبيقات

يستخدم الملايين من المواقع الإلكترونية خدمة "إحصاءات Google". نضع حدودًا وحصصًا على طلبات البيانات من واجهة برمجة التطبيقات لحماية النظام من تلقّي بيانات أكثر مما يمكنه التعامل معها، ولضمان توزيع عادل لموارد النظام. تخضع الحدود والحصص للتغيير.

حدود المعدل

تحدّد الحدود القصوى لمعدل واجهة برمجة التطبيقات عدد الطلبات التي يمكن إجراؤها إلى Google Analytics Admin API. يتم فرض حدود المعدل وإعادة تعبئته تلقائيًا خلال فواصل زمنية مدتها 60 ثانية (دقيقة واحدة). وهذا يعني أنه إذا وصل مشروعك إلى الحد الأقصى لمعدّل البيانات في أي وقت خلال 60 ثانية، عليك الانتظار حتى تتم إعادة ملء هذه الحصة قبل تقديم المزيد من الطلبات في تلك المجموعة. إذا تجاوز مشروعك حد المعدل، ستتلقى خطأ 403 بسبب rateLimitExceeded. لحل هذا الخطأ، انتظر دقيقة ثم جرِّب طلبك مرة أخرى، ويجب إعادة ملء الحصة في بداية الفاصل الزمني التالي.

يكون الحد الأقصى لعدد طلبات البيانات اليومية من واجهة برمجة التطبيقات مقيدًا بحدود معدّل استخدام واجهة برمجة التطبيقات، ولا تتوفّر حاليًا حصة استخدام يومية صريحة لواجهة برمجة التطبيقات Google Analytics Admin API.

حصص المشاريع على Google Cloud

يتم تطبيق حدود معدل واجهة برمجة التطبيقات على أساس كل مشروع على حدة.

تعرض Cloud Console حصصًا لمشروع Cloud: https://console.cloud.google.com/apis/api/analyticsadmin.googleapis.com/quotas.

في ما يلي الحصص التلقائية لواجهة Google Analytics Admin API التي سيراها معظم المستخدمين في وحدة التحكّم. يُرجى العلم أنّه قد يتم تقييد حدود الحصة تلقائيًا للمشروعات التي تنتهك بنود خدمة "إحصاءات Google".

اسم الحصة الحدّ المسموح به
الطلبات في الدقيقة 1200
الطلبات في الدقيقة لكل مستخدم 600
الكتابة في الدقيقة 600
الكتابة في الدقيقة لكل مستخدم 180

يستهلك كل طلب إلى Google Analytics Admin API حصصًا تبلغ Requests per minute، Requests per minute per user. إنّ الطلبات المقدّمة إلى أي طريقة تغيّر إعدادات حساب "إحصاءات Google" بأي شكل من الأشكال (طرق create وpatch وdelete وarchive وupdate) تستهلك أيضًا حصصًا في Writes per minute وWrites per minute per user.

يُرجى الرجوع إلى مقالة استخدام واجهة برمجة التطبيقات (Capping API) للاطّلاع على معلومات حول الحدّ من طلبات البيانات من واجهة برمجة التطبيقات على أساس كل مستخدم.