حصص استخدام Mail Admin Quarantine API

تفرض واجهة Mail Admin Quarantine API حصص استخدام لكل دقيقة لكل مشروع على السحابة الإلكترونية على Google Cloud من أجل حماية البنية الأساسية في Google Workspace التي تبحث عن الرسائل المعزولة وتستردّها. يتم تجميع الحصص حسب نوع العمل الذي تؤديه الطريقة.

الحِصص

يعرض الجدول التالي الحصص. يتم احتساب كل حصة في الدقيقة لكل مشروع على السحابة الإلكترونية، ويتم احتساب جميع الطلبات التي يقدّمها المشروع لجميع عملاء Google Workspace والمشرفين المنتحلين للهوية.

الحصة القيمة الطُرق
طلبات البحث والقوائم ‫60 طلب في الدقيقة customers.quarantinedMessages.list، customers.quarantinedMessages.search
طلبات القراءة ‫1,200 طلب في الدقيقة customers.quarantinedMessages.get، customers.quarantines.get، customers.quarantines.list، customers.operations.get
طلبات الكتابة ‫300 طلب في الدقيقة customers.quarantinedMessages.release، customers.quarantinedMessages.deny، customers.quarantinedMessages.batchRelease، customers.quarantinedMessages.batchDeny

يتم احتساب كل طلب بيانات من واجهة برمجة التطبيقات كطلب واحد، بغض النظر عن حجم الصفحة أو عدد الرسائل في الدفعة بالنسبة إلى طرق الدفعات. على سبيل المثال، يستهلك طلب batchRelease الذي يتضمّن 500 رسالة طلب كتابة واحدًا.

يمكنك الاطّلاع على نسبة استخدام الحصة الحالية لمشروعك في Google Cloud Console ضمن واجهات برمجة التطبيقات والخدمات > واجهات برمجة التطبيقات والخدمات المفعَّلة > Admin Quarantine API > الحصص والحدود القصوى للنظام.

قيود الطلبات

القيد القيمة
الحد الأقصى لعدد الطلبات هو pageSize لطلبات list وsearch ‫300 رسالة
الحدّ الأقصى لعدد الرسائل لكل طلب من batchRelease أو batchDeny ‫500 رسالة
نافذة البحث والقائمة الرسائل المستلَمة في آخر 30 يومًا

حلّ أخطاء الحصة

عندما يتجاوز مشروعك حصة معيّنة، تعرض واجهة برمجة التطبيقات خطأ HTTP 429 مع الحالة RESOURCE_EXHAUSTED:

{
  "error": {
    "code": 429,
    "message": "Quota exceeded for quota metric 'Search and list quarantined messages requests' and limit 'Search and list requests per minute per project' of service 'mailadminquarantine.googleapis.com' for consumer 'project_number:123456789012'.",
    "status": "RESOURCE_EXHAUSTED"
  }
}

للبقاء ضمن حدود الحصص:

  • أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي. عند ظهور الخطأ 429، يُرجى الانتظار قبل إعادة المحاولة وزيادة وقت الانتظار بعد كل محاولة فاشلة. لمعرفة التفاصيل، يُرجى الاطّلاع على خوارزمية الرقود الأسي الثنائي.
  • استخدِم أكبر حجم صفحة مفيد. طلبات البحث والقائمة لها أصغر حصة. يمكنك طلب ما يصل إلى 300 رسالة لكل صفحة بدلاً من العديد من الصفحات الصغيرة.
  • استخدِم الفلاتر. يمكنك تضييق نطاق طلبات search باستخدام filter أو query حتى تتمكن من استرداد الرسائل التي تحتاجها فقط.
  • استخدِم طرق الدفعات للإجراءات المجمّعة. يمكن لطلب واحد من batchRelease أو batchDeny إصدار أو رفض ما يصل إلى 500 رسالة، مقارنةً برسالة واحدة لكل طلب من release أو deny.
  • استخدِم عمليات الاستطلاع بشكل مقتصد. عند انتظار عملية مجمّعة، يمكنك استدعاء طريقة get لمورد customers.operations كل بضع ثوانٍ بدلاً من استدعائها بشكل مستمر.
  • المزامنة بشكل تدريجي: بدلاً من إعادة إدراج وحدة العزل بالكامل في كل عملية تشغيل، يمكنك الفلترة حسب status = PENDING_TRIAGE ومعالجة الرسائل الجديدة فقط.

لا تتوفّر زيادة الحصص خلال فترة "معاينة المطوّر". إذا كانت حالة الاستخدام تتطلّب حصصًا أعلى، يمكنك مشاركة ملاحظاتك من خلال برنامج معاينة المطوّرين في Google Workspace.