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

نضع حدودًا وحصصًا على طلبات واجهة برمجة التطبيقات لحماية النظام من تلقّي المزيد من البيانات التي لا يمكنه التعامل معها، ولضمان توزيعٍ عادلٍ لموارد النظام. تخضع الحدود والحصص للتغيير.

حدود معدّل الاستخدام

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

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

حصص مشاريع السحابة الإلكترونية

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

تعرِض Cloud Console حصص "مشروع Cloud": https://console.cloud.google.com/apis/api/marketingplatformadmin.googleapis.com/quotas.

في ما يلي الحصص التلقائية لواجهة برمجة التطبيقات Admin API في "منصّة Google للتسويق" والتي سيراها معظم المستخدِمين في وحدت تحكّمهم.

اسم الحصة الحدّ
الطلبات في الدقيقة 1200
الطلبات في الدقيقة لكل مستخدم 600
عدد الرسائل المكتوبة في الدقيقة 300
عمليات الكتابة في الدقيقة لكل مستخدم 120

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

يمكنك الرجوع إلى مقالة وضع حدود لاستخدام واجهة برمجة التطبيقات للحصول على معلومات عن الحد من طلبات واجهة برمجة التطبيقات لكل مستخدم.