الحدود القصوى والحصص للاستخدام

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

في حال تعذّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات، من المحتمل أن تتلقّى استجابة رمز حالة HTTP. يحتوي رمز الحالة 403 على معلومات خطأ حول الإدخال غير الصحيح، ويحتوي رمز حالة HTTP لـ 503 على معلومات خطأ تشير إلى حصص واجهات برمجة التطبيقات التي تم تجاوزها. وتسمح هذه الاستجابات لتطبيقك المخصّص باكتشاف هذه الأخطاء واتخاذ الإجراء المناسب.

إذا كنت بحاجة إلى إكمال طلباتك في فترة زمنية محدّدة، أرسِل طلباتك بالتوازي أو استخدِم سلاسل محادثات متعدّدة في تطبيق جافا أو C#. ومن أمثلة الطلبات الموازية طلب مجموعات صغيرة من الرسائل الإلكترونية من مستخدمين مختلفين بدلاً من إضافة أو إزالة الكثير من الرسائل الإلكترونية من مستخدم واحد في الوقت نفسه. في حالة سلاسل المحادثات، جرِّب البدء بـ 10 سلاسل محادثات، سلسلة محادثات واحدة لكل بريد إلكتروني للمستخدم. يُرجى العِلم أنّ اقتراح سلسلة المحادثات يتضمّن مفاضلات وليس مفيدًا لجميع حالات واجهة برمجة التطبيقات. في حال ارتفاع عدد الطلبات أكثر من اللازم، قد تحدث أخطاء في الحصة. ومثال آخر على ذلك هو حصة واجهة برمجة تطبيقات تدقيق البريد الإلكتروني للحد الأقصى لمعدل إجمالي تحميل الرسائل. معدل التحميل هو طلب واجهة برمجة تطبيقات واحد في الثانية، لكل مستخدم، بغض النظر عن عدد سلاسل المحادثات التي ترسل طلبات التحميل.

بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (الحد الأقصى N من الثواني للعدد N ثانية لكل سلسلة محادثات)، لا سيما أخطاء رمز الحالة 503، ننصحك بأن ترصد رموزك الاستثناء، وباستخدام خوارزمية التراجع الأسي ، يمكنك الانتظار لفترة تأخير قصيرة قبل إعادة محاولة المكالمة التي تعذّر تنفيذها. من أمثلة واجهة برمجة تطبيقات تدقيق البريد الإلكتروني لسلسلة محادثات الانتظار لمدة 5 ثوانٍ وإعادة محاولة المكالمة التي تعذّر تنفيذها. إذا نجح الطلب، كرِّر هذا النمط لسلاسل المحادثات الأخرى. إذا لم ينجح الطلب الثاني، يجب تقليل نطاق تكرار الطلب إلى أن يتم إجراء المكالمة بنجاح. على سبيل المثال، يمكنك زيادة مدة المهلة الأولية التي تبلغ 5 ثوانٍ إلى 10 ثوانٍ وإعادة محاولة مكالمتك التي تعذّر إجراؤها مرة أخرى. ويمكنك أيضًا تحديد حد لإعادة المحاولة. على سبيل المثال، يمكنك إعادة محاولة الطلب من 5 إلى 7 مرات مع أوقات تأخير مختلفة قبل أن يعرض التطبيق خطأً للمستخدم.

يسرد الجدول التالي حدود واجهة برمجة تطبيقات تدقيق البريد الإلكتروني:

فئات حدود واجهة برمجة التطبيقات الحدود القصوى المسموح بها
إنشاء الملفات المشفّرة في صندوق البريد الإلكتروني قد يستغرق إنشاء ملفات صندوق البريد الإلكتروني المشفّرة ما يصل إلى عدة أيام لتجهيز النظام، وذلك حسب الحجم.
ملفات صندوق البريد المشفّرة، الأخطاء المتعلقة بالحذف عند حذف صندوق بريد مشفّر وظهور أخطاء، يتم منح الطلب حالة MARKED_DELETE. وتتولّى Google تلقائيًا حذف هذه الملخّصات وملفات التصدير مرة أخرى في غضون 24 ساعة (مع باقي الملفات المتبقية). إذا تم عرض حالة MARKED_DELETE بشكل متّسق، جرّب استراتيجية تراجع أسي.

يدرج الجدول التالي حصص واجهة برمجة تطبيقات تدقيق البريد الإلكتروني:

فئات حصة واجهة برمجة التطبيقات الحصص
الرموز المميزة لمصادقة ClientLogin صالحة لمدة 24 ساعة. الخطأ 401 token expired.
تنسيقات التاريخ حوِّل جميع التواريخ إلى تنسيق التوقيت العالمي المنسق (UTC) قبل استخدامها مع واجهة برمجة تطبيقات تدقيق البريد الإلكتروني. ولمزيد من المعلومات، يُرجى الاطّلاع على محوِّل التوقيت العالمي المنسَّق.
ملفات صندوق البريد المشفّرة وملخصات EXPIRED وملفات التصدير تحتفظ Google بملفات صندوق البريد المشفّرة لمدة 3 أسابيع. وبعد هذه المدة، يتم حذفها. ويتحمل مشرف النطاق مسؤولية تنزيل ملفات صندوق البريد هذه خلال هذه الفترة الزمنية.
ملفات صندوق البريد المشفّر، التنسيق تكون ملفات صندوق البريد المشفّر بتنسيق mbox.
ملفات صندوق البريد المشفّرة، الحد الأقصى لطلبات الإنشاء يبلغ الحد الأقصى لطلبات إنشاء تصدير صندوق البريد في اليوم 100 طلب من جميع المشرفين في النطاق.
حالة ملف صندوق البريد المشفّر والتقسيم على صفحات عند طلب حالة جميع طلبات صندوق البريد الإلكتروني، يمكن أن تعرض الردود كميات كبيرة من البيانات. تعمل واجهة برمجة تطبيقات تدقيق البريد الإلكتروني على تجميع هذه البيانات في صفحات تحتوي كل صفحة على 100 إدخال كحد أقصى، ومعرّف الموارد المنتظم (URI) في link rel='next'علامة تشير إلى صفحة النتائج التالية. عند تطوير تطبيق العميل، يجب أن يدير الرمز هذه النتائج الإضافية.
أداة مراقبة البريد الإلكتروني الحد الأقصى لعدد طلبات مراقبة البريد الإلكتروني في اليوم هو 1500. ويسري هذا الحدّ الأقصى المسموح به على النطاق ويشمل جميع الطلبات التي يقدّمها أي مشرف خلال اليوم.
المفتاح العام تتيح واجهة برمجة تطبيقات تدقيق البريد الإلكتروني دعم مفتاح واحد فقط.

يستخدم المفتاح العام برنامج GNU Privacy Guard (GPG). وتُعد هذه اللغة بتنسيق PGP وهو مفتاح ترميز RSA بترميز ASCII. قبل تحميل المفتاح العام، عليك تحويله أولاً إلى سلسلة مشفّرة base64. يجب أن تتم قراءة ملف المفتاح العمومي باستخدام أحرف US-ASCII, (IANA اسم مجموعة الأحرف المفضّلة لترميز ASCII).

جارٍ البحث معلمتا searchQuery وincludeDeleted منفصلتان بشكل تبادلي. لا يمكن استخدام طلب بحث إذا كان includeDeleted="true".