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