تعمل الحدود والحصص على حماية بنية Google الأساسية من عملية مُبرمَجة تستخدم واجهة برمجة تطبيقات إعدادات "مجموعات Google" بطريقة غير ملائمة. قد تنشأ الطلبات الزائدة من واجهة برمجة التطبيقات عن خطأ إملائي غير ضار أو نظام مصمم بشكل غير فعال لإجراء استدعاءات غير ضرورية لواجهة برمجة التطبيقات. وبغض النظر عن السبب، من الضروري حظر الزيارات من مصدر معيّن عندما تصل إلى مستوى معيّن للحفاظ على سلامة نظام Google Workspace بشكل عام.
حالات تعذُّر طلبات البيانات من واجهة برمجة التطبيقات
في حال تعذُّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات، وهو أمر مستبعد، يتلقّى تطبيقك استجابة رمز حالة HTTP. يتضمّن رمز حالة HTTP لـ 403 معلومات خطأ تشير إلى تجاوز حصص واجهة برمجة التطبيقات. تسمح الاستجابة لتطبيقك المخصص باكتشاف الأخطاء واتخاذ الإجراء المناسب.
الطلبات الحسّاسة للوقت
إذا كانت هناك حاجة إلى إكمال طلباتك في فترة زمنية ثابتة، فأرسل طلباتك بالتوازي أو استخدم سلاسل محادثات متعددة في تطبيق Java أو C#. على سبيل المثال، قسِّم طلباتك حسب الشهر أو فترة زمنية أخرى. في حال استخدام سلاسل محادثات، يُرجى البدء بـ 10 سلاسل محادثات، مع العلم أنّ كل سلسلة محادثات واحدة لكل طلب. يحتوي اقتراح سلسلة المحادثات على مُفاضلات وهو ليس مفيدًا لجميع حالات واجهة برمجة التطبيقات. إذا أصبح عدد الطلبات مرتفعًا جدًا، تحدث أخطاء في الحصة.
أخطاء مستندة إلى الوقت
بالنسبة إلى جميع الأخطاء التي تستند إلى الوقت (بحد أقصى عدد N أشياء في X ثانية لكل سلسلة محادثات)، وخاصةً أخطاء رمز الحالة 503، ننصح بأن يستوعب الرمز الاستثناء الخاص بالرمز، وباستخدام خوارزمية
التراجع الأسّي، انتظِر قليلاً قبل إعادة محاولة الاتّصال الذي تعذّر تنفيذه. أحد أمثلة واجهة برمجة تطبيقات إعدادات المجموعات
لسلسلة محادثات واحدة هو الانتظار 5 ثوانٍ وإعادة محاولة الاتصال الفاشلة. إذا كان الطلب ناجحًا، فكرر هذا
النمط للسلاسل الأخرى. إذا لم ينجح الطلب الثاني، يجب أن يقلّل تطبيقك من معدل تكرار الطلب حتى يتم إجراء الاتصال بنجاح. على سبيل المثال، يمكنك زيادة التأخير الأولي وهو 5 ثوانٍ إلى 10 ثوانٍ، ثم إعادة محاولة إجراء المكالمة التي تعذّر تنفيذها مرة أخرى. أيضًا، اتخذ قرارًا بشأن
الحد الأقصى لإعادة المحاولة. على سبيل المثال، يمكنك إعادة محاولة تقديم طلب من 5 إلى 7 مرات بأوقات تأخير مختلفة قبل أن يعرض التطبيق
خطأً للمستخدم.
الحصص
| فئات حصص واجهة برمجة التطبيقات | الحصص |
|---|---|
| طلبات البحث في اليوم | يمكنك إجراء ما يصل إلى 100,000 طلب بحث في اليوم. وإذا كنت بحاجة إلى سعة تتجاوز هذا الحدّ، يمكنك إرسال طلب من صفحة الحصص في Google Cloud Console. |
| وصف المجموعة، الحد الأقصى للحجم | يمكنك إدخال وصف مجموعة لا يتجاوز طوله 300 حرف. |
| اسم المجموعة، الحد الأقصى للحجم | يمكن أن يصل اسم المجموعة إلى 60 حرفًا. |
defaultMessageDenyNotificationText |
ويمكن أن يصل طول نص الإشعار إلى 10,000 حرف. للمزيد من المعلومات حول السمة
defaultMessageDenyNotificationText، يمكنك الاطّلاع على
مرجع واجهة برمجة التطبيقات.
|
maxMessageBytes |
ويبلغ الحد الأقصى التلقائي لحجم الرسالة 1 ميغابايت. للمزيد من المعلومات حول السمة maxMessageBytes،
يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات.
|
الحدود المسموح بها
| أنواع الحدود | القيود والإرشادات |
|---|---|
| تنسيق البيانات (التنسيق التلقائي) |
تنسيق البيانات التلقائي هو JSON. تتوافق واجهة برمجة التطبيقات أيضًا مع تنسيق Atom. يدعم كل من تنسيقي بيانات JSON وAtom إمكانات القراءة الكاملة. لمزيد من المعلومات، يمكنك الاطّلاع على تنسيقات بيانات JSON وAtom. |
| واجهة برمجة تطبيقات إعدادات المجموعات، التفعيل | يجب تفعيل واجهة برمجة التطبيقات للدليل قبل إجراء مكالمات مع واجهة برمجة تطبيقات إعدادات "مجموعات Google". لمزيد من المعلومات، يُرجى الاطّلاع على تفعيل واجهات برمجة تطبيقات Google Workspace. |