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