تساعد الحدود والحصص في حماية بنية Google الأساسية من العمليات التلقائية التي تستخدم واجهة برمجة التطبيقات Email Audit API بطريقة غير ملائمة. قد تنتج الطلبات المفرطة من واجهة برمجة التطبيقات عن خطأ إملائي غير ضار، أو قد تنتج عن نظام مصمّم بشكل غير فعّال يرسل طلبات غير ضرورية إلى واجهة برمجة التطبيقات. وبغض النظر عن السبب، من الضروري حظر الزيارات الواردة من مصدر معيّن عندما تصل إلى مستوى معيّن، وذلك للحفاظ على سلامة نظام Google Workspace بشكل عام. تساعد الحدود في ضمان عدم تأثير إجراءات أحد المطوّرين سلبًا في المنتدى الأكبر.
في حال تعذُّر تنفيذ طلبك من خلال واجهة برمجة التطبيقات، ستتلقّى استجابة تتضمّن رمز حالة HTTP. يتضمّن رمز الحالة 403 معلومات خطأ حول الإدخال غير الصحيح، ويتضمّن رمز حالة HTTP 503 معلومات خطأ تشير إلى تجاوز حصص استخدام واجهة برمجة التطبيقات. تتيح هذه الاستجابات لتطبيقك المخصّص رصد هذه الأخطاء واتّخاذ الإجراء المناسب.
إذا كانت طلباتك بحاجة إلى أن يتم إكمالها خلال فترة زمنية محددة، أرسِل طلباتك بالتوازي أو استخدِم سلاسل محادثات متعددة في تطبيق Java أو C#. ومن الأمثلة على الطلبات المتوازية طلب مجموعات صغيرة من الرسائل الإلكترونية من مستخدمين مختلفين بدلاً من إضافة أو إزالة الكثير من الرسائل الإلكترونية من مستخدم واحد في الوقت نفسه. في ما يتعلّق بسلاسل المحادثات، جرِّب البدء بـ 10 سلاسل محادثات، سلسلة واحدة لكل بريد إلكتروني خاص بالمستخدم. يُرجى العِلم أنّ اقتراح سلسلة المحادثات له مزايا وعيوب، ولا يكون مفيدًا في جميع حالات استخدام واجهة برمجة التطبيقات. إذا ارتفع عدد الطلبات بشكل كبير، ستحدث أخطاء في الحصة. مثال آخر على المفاضلة هو الحصة المخصّصة لواجهة برمجة التطبيقات Email Audit API لأقصى معدّل إجمالي لتحميل الرسائل. معدّل التحميل هو طلب واحد من واجهة برمجة التطبيقات في الثانية لكل مستخدم، بغض النظر عن عدد سلاسل المحادثات التي ترسل طلبات التحميل.
بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (الحد الأقصى هو N عنصر في N ثانية لكل سلسلة محادثات)، وخاصةً أخطاء رمز الحالة 503، ننصح بأن يرصد الرمز الاستثناء، وأن ينتظر فترة تأخير قصيرة قبل إعادة محاولة إجراء المكالمة التي تعذّر إجراؤها، وذلك باستخدام خوارزمية التراجع الأسي. أحد الأمثلة على استخدام Email Audit API في سلسلة محادثات واحدة هو الانتظار لمدة 5 ثوانٍ ثم إعادة محاولة تنفيذ الطلب الذي تعذّر تنفيذه. إذا نجح الطلب، كرِّر هذا النمط مع سلاسل المحادثات الأخرى. إذا لم ينجح الطلب الثاني، يجب أن يقلّل تطبيقك من معدّل تكرار الطلب إلى أن ينجح أحد الطلبات. على سبيل المثال، يمكنك زيادة مدة التأخير الأولية من 5 ثوانٍ إلى 10 ثوانٍ، ثم إعادة محاولة إجراء المكالمة التي تعذّر إجراؤها. حدِّد أيضًا عدد محاولات إعادة التشغيل. على سبيل المثال، أعِد محاولة تنفيذ الطلب 5 إلى 7 مرات مع فترات تأخير مختلفة قبل أن يعرض تطبيقك رسالة خطأ للمستخدم.
يسرد الجدول التالي حدود Email Audit API:
| فئات حدود واجهة برمجة التطبيقات | الحدود |
|---|---|
| إنشاء ملفات صندوق البريد المشفَّرة |
قد يستغرق إنشاء ملفات صندوق البريد المشفّرة عدة أيام حتى يتمكّن النظام من إعدادها، وذلك حسب حجمها. |
| ملفات صندوق البريد المشفّرة، أخطاء في الحذف |
عند
حذف
علبة بريد مشفّرة وحدوث أخطاء، يتم منح الطلب الحالة
|
يسرد الجدول التالي الحصص المخصّصة لواجهة Email Audit API:
| فئات حصص واجهة برمجة التطبيقات | الحصص |
|---|---|
| رموز المصادقة المميزة في ClientLogin |
صالحة لمدة 24 ساعة. الخطأ هو |
| تنسيقات التاريخ |
حوِّل جميع التواريخ إلى تنسيق التوقيت العالمي المنسَّق (UTC) قبل استخدامها مع Email Audit API. لمزيد من المعلومات، اطّلِع على أداة تحويل التوقيت العالمي المنسَّق. |
|
ملفات صندوق البريد المشفَّرة وملخّصات |
تحتفظ Google بملفات صندوق البريد المشفّرة لمدة 3 أسابيع. وبعد هذه المدة، يتم حذفها. ويتحمّل مشرف النطاق مسؤولية تنزيل ملفات صندوق البريد هذه خلال هذه الفترة الزمنية. |
| ملفات صندوق البريد المشفَّرة، التنسيق |
تكون ملفات صندوق البريد المشفّرة بتنسيق mbox. |
| ملفات صندوق البريد المشفّرة، الحد الأقصى لطلبات الإنشاء |
يبلغ الحد الأقصى لطلبات إنشاء عمليات تصدير علب البريد 100 طلب في اليوم من جميع المشرفين في النطاق. |
| حالة ملف صندوق البريد المشفَّر، تقسيم إلى صفحات |
عند طلب حالة جميع طلبات علب البريد، يمكن أن تعرض الردود كميات كبيرة من البيانات. تجمّع واجهة برمجة التطبيقات Email Audit API هذه البيانات في صفحات، ويحتوي كل صفحة على 100 إدخال كحد أقصى، بالإضافة إلى معرّف موارد منتظم (URI) في علامة |
| مراقبة البريد الإلكتروني |
الحد الأقصى لعدد طلبات مراقبة البريد الإلكتروني في اليوم هو 1500 طلب. ينطبق هذا الحد على النطاق ويشمل جميع الطلبات التي يقدّمها أي مشرف خلال اليوم. |
| المفتاح العام |
تتيح واجهة برمجة تطبيقات "تدقيق الرسائل الإلكترونية" استخدام مفتاح واحد فقط. يستخدم المفتاح العام برنامج GNU Privacy Guard (GPG). ويكون بتنسيق PGP وهو مفتاح تشفير RSA بترميز ASCII. قبل تحميل المفتاح العام، يجب أولاً تحويله إلى سلسلة مرمّزة باستخدام Base64. يجب أن يكون ملف المفتاح العام قابلاً للقراءة باستخدام مجموعة الأحرف US-ASCII (IANA هو اسم مجموعة الأحرف المفضّل لترميز ASCII). |
| جارٍ البحث |
تستبعد المَعلمتان |