تعمل الحدود والحصص على حماية بنية Google الأساسية من عملية مبرمَجة تستخدم Data Transfer API بطريقة غير ملائمة. وقد تنتج الطلبات المفرطة من واجهة برمجة التطبيقات عن خطأ إملائي غير مؤذٍ أو قد تنتج عن نظام مصمّم بشكل غير فعال لإجراء طلبات غير ضرورية من واجهة برمجة التطبيقات. بغض النظر عن السبب، من الضروري حظر الزيارات من مصدر معيّن عندما يصل إلى مستوى معيّن للحفاظ على سلامة نظام Google Workspace بشكل عام. ويضمن هذا الوضع ألا تؤثر إجراءات أحد مطوّري البرامج سلبًا في المنتدى الأكبر.
حالات تعذُّر طلبات البيانات من واجهة برمجة التطبيقات
في حال تعذّر طلب البيانات من واجهة برمجة التطبيقات، وهو أمر مستبعد، يتلقّى تطبيقك استجابة رمز حالة HTTP. يتضمّن رمز الحالة 403 معلومات خطأ متعلّقة بالإدخال غير الصحيح، ورمز حالة HTTP لـ 503 يتضمّن معلومات خطأ تشير إلى حصص واجهة برمجة التطبيقات التي تم تجاوزها. تسمح هذه الردود لتطبيقك المخصّص باكتشاف هذه الأخطاء واتّخاذ الإجراء المناسب.
إكمال الطلبات خلال فترة زمنية محددة
إذا كانت هناك حاجة إلى إكمال طلباتك خلال فترة زمنية ثابتة، أرسِل طلباتك بالتوازي أو استخدِم سلاسل محادثات متعددة في تطبيق Java أو C# . على سبيل المثال، يمكنك تقسيم طلباتك حسب الشهر أو فترة زمنية أخرى. في حال استخدام سلاسل محادثات، جرِّب البدء بـ 10 سلاسل محادثات، مع الحرص على أن تكون سلسلة محادثات واحدة لكل طلب. يحتوي اقتراح سلسلة المحادثات على حلول بديلة ولا يفيد في جميع حالات واجهات برمجة التطبيقات. وفي حال كان عدد الطلبات مرتفعًا جدًا، ستحدث أخطاء في الحصة.
أخطاء مستندة إلى الوقت
بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (بحد أقصى عدد N أشياء في X ثانية لكل سلسلة محادثات)، وخاصةً أخطاء رمز الحالة 503، ننصحك بأن يتعرَّف الرمز على الاستثناء وباستخدام خوارزمية
التراجع الأسّي، انتظِر قليلاً قبل إعادة محاولة إجراء المكالمة التي تعذّر تنفيذها. من أمثلة Data Transfer API
لسلسلة محادثات واحدة، الانتظار لمدة 5 ثوانٍ وإعادة محاولة إجراء الاتصال الذي تعذّر تنفيذه. وفي حال نجاح الطلب،
يمكنك تكرار هذا النمط لسلاسل المحادثات الأخرى. أما في حال عدم نجاح الطلب الثاني، فيجب أن يقلل طلبك من معدّل تكرار الطلب إلى أن يتم قبول الطلب. على سبيل المثال، يمكنك زيادة المهلة الأولية التي تبلغ 5 ثوانٍ إلى 10 ثوانٍ وإعادة محاولة إجراء المكالمة التي تعذّر تنفيذها مرة أخرى. ويمكنك أيضًا
اختيار الحدّ الأقصى لإعادة المحاولة. على سبيل المثال، يمكنك إعادة محاولة تقديم طلب من 5 إلى 7 مرات مع أوقات تأخير مختلفة
قبل أن يعرض التطبيق رسالة خطأ للمستخدم.
الحدود المسموح بها
| فئات حدود واجهة برمجة التطبيقات | الحدود المسموح بها |
|---|---|
| طلبات البحث في الثانية (QPS) | حد مشروع المطوِّر هو 10 طلبات في الثانية (QPS) لكل حساب. |
الحصص
| فئات حصص واجهة برمجة التطبيقات | الحصص |
|---|---|
| الحد الأقصى لطلبات البيانات من واجهة برمجة التطبيقات في اليوم | الحد الأقصى لعدد طلبات البيانات من واجهة برمجة التطبيقات في اليوم هو 500,000. |
| الأرشيف وانتهاء صلاحية الرسائل | أرشيفات المجموعة لا تنتهي صلاحيتها. وتبقى الرسائل في الأرشيف إلى أن يتم حذف المجموعة. ولا تؤثر سياسة الاحتفاظ بالبريد الإلكتروني في الرسائل داخل أرشيف المجموعة. |
| حجم رسالة البريد | الحد الأقصى لحجم رسالة البريد هو 25 ميغابايت. ويشمل هذا الحدّ عناوين البيانات الوصفية ونص الرسالة وأي مرفقات فيها. |
الأنواع الأخرى من الحدود
| الأنواع الأخرى من الحدود | القيود والإرشادات |
|---|---|
| تنسيقات أنواع المحتوى | يجب أن تكون الرسالة الإلكترونية بتنسيق
RFC 822 النصي العادي.
يستخدم تنسيق نوع المحتوى للطلب لتحميل الرسائل الإلكترونية التي تم نقلها
العنوان Content-type: message/rfc822.
|
| تنسيق البيانات في ردود واجهة برمجة التطبيقات | يكون تنسيق بيانات الرد هو JavaScript Object Notation (JSON). |
| سياسات الموقع الجغرافي للبيانات | لا تتوافق واجهة برمجة التطبيقات Data Transfer API مع سياسات الموقع الجغرافي للبيانات التي تتطلّب تخزين البيانات في حدود جغرافية أو سياسية معيّنة لأسباب تعاقدية. لا تستخدم واجهة برمجة التطبيقات Data Transfer API إذا كان الموقع الجغرافي للبيانات مطلوبًا لحسابك. |
| إدراجات الرسائل المتوازية | تتيح واجهة برمجة التطبيقات Data Transfer API تقديم طلبات متوازية لإدراج البريد الإلكتروني في أرشيفات مجموعات مختلفة. في المقابل، لا تتيح واجهة برمجة التطبيقات Data Transfer API إدراج الرسائل الموازية في أرشيف المجموعة نفسه. ولا يتيح هذا الإصدار من واجهة برمجة التطبيقات استخدام الطلبات المجمّعة. |
| الطلبات غير المصرّح بها | لا تقبل واجهة برمجة التطبيقات Data Transfer API أي طلبات غير مصرّح بها. يُعتبَر الطلب غير مصرّح به في حال عدم تقديم رمز مميّز للتفويض. |