الحدود القصوى والحصص للاستخدام

تحمي الحدود والحصص بنية Google الأساسية من عملية تلقائية تستخدم واجهة برمجة تطبيقات إعدادات المشرف بطريقة غير ملائمة. قد تنجم الطلبات الزائدة عن واجهة برمجة التطبيقات عن خطأ إملائي غير مؤذٍ، أو ربما تنشأ عن نظام مصمم بشكل غير فعّال يستدعي استدعاءات واجهة برمجة التطبيقات غير الضرورية. بغض النظر عن السبب، من الضروري حظر الزيارات من مصدر محدّد بعد بلوغ مستوى معيّن للحفاظ على سلامة نظام Google Workspace بشكل عام. ويضمن ذلك عدم تأثير إجراءات مطوّر البرامج سلبًا على المنتدى الأكبر حجمًا.

في حالة فشل طلب واجهة برمجة التطبيقات على الأرجح، ستتلقى استجابة رمز حالة HTTP. يحتوي رمز الحالة 403 على معلومات خطأ حول الإدخال غير الصحيح، ويحتوي رمز حالة HTTP 503 على معلومات خطأ تشير إلى حصص واجهات برمجة التطبيقات التي تم تجاوزها. تتيح هذه الاستجابات لتطبيقك المخصص اكتشاف هذه الأخطاء واتخاذ الإجراء المناسب.

إذا كنت بحاجة إلى إكمال طلباتك في فترة زمنية محددة، فأرسل طلباتك بالتوازي أو استخدم سلاسل محادثات متعددة في تطبيق جافا أو C#. على سبيل المثال، قسِّم طلباتك حسب الشهر أو فترة زمنية أخرى. في حال سلاسل المحادثات، حاوِل البدء بـ 10 سلاسل محادثات، سلسلة محادثات واحدة لكل طلب. تجدر الإشارة إلى أن توصية سلسلة المحادثات تشتمل على بعض المفاضلات وليست مفيدة لجميع حالات واجهة برمجة التطبيقات. وفي حال كان عدد الطلبات مرتفعًا جدًا، ستحدث أخطاء في الحصة.

بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (بحد أقصى N من العناصر لمدة X ثانية لكل سلسلة محادثات)، وخاصةً أخطاء رمز الحالة 503، نوصي بأن يلتقط الرمز الاستثناء، وباستخدام خوارزمية التراجع الأسي، انتظِر فترة تأخير صغيرة قبل إعادة محاولة الاتصال الذي تعذّر تنفيذه. مثال على واجهة برمجة تطبيقات إعدادات البريد الإلكتروني لسلسلة محادثات واحدة هو الانتظار 5 ثوانٍ وإعادة محاولة المكالمة التي تعذّر تنفيذها. إذا نجح الطلب، كرِّر هذا النمط لسلاسل المحادثات الأخرى. في حال عدم نجاح الطلب الثاني، يجب أن يقلّل تكرار الطلب من فترة تكراره إلى أن يتم إجراء المكالمة بنجاح. على سبيل المثال، يمكنك زيادة مدة المهلة الأولية التي تبلغ 5 ثوانٍ إلى 10 ثوانٍ وإعادة محاولة إجراء المكالمة التي تعذّر إجراؤها مرة أخرى. ويمكنك أيضًا تحديد حد لإعادة المحاولة. على سبيل المثال، أعد محاولة تقديم الطلب من 5 إلى 7 مرات مع أوقات تأخير مختلفة قبل أن يعرض التطبيق خطأ للمستخدم.

فئات حصة واجهة برمجة التطبيقات	الحصص
الرموز المميزة لمصادقة ClientLogin	صالحة لمدة 24 ساعة. الخطأ هو "انتهت صلاحية الرمز المميز 401".
إنشاء مفاتيح عامة وخاصة	باستخدام موفِّر الهوية، يمكنك إنشاء مجموعة من المفاتيح العامة والخاصة باستخدام خوارزميات DSA أو RSA. المفتاح العام متوفر بتنسيق شهادة X.509. لمزيد من المعلومات عن مفاتيح توقيع الدخول الموحَّد المستندة إلى SAML، يُرجى الاطِّلاع على إنشاء المفاتيح والشهادات لخدمة الدخول الموحَّد في Google Workspace.
شعار	يمكن أن يكون ملف صورة شعار الحساب بتنسيق JPEG أو PNG أو GIF. الحجم الموصى به هو 143 × 59 بكسل ويجب أن يكون حجم الملف أصغر من 20 كيلوبايت. عند استخدام الشعارات المخصّصة، احرص على الالتزام ببنود الخدمة في Google. والامتناع عن استخدام شعار Google أو شعار Gmail أو أي شعارات أخرى لشركة Google. لمزيد من المعلومات، اطّلع على سياسات الشعار والصفحة المقصودة.
إضافة إلى القائمة البيضاء	ssoWhitelist هو عنوان IP لقناع شبكة بتنسيق التوجيه بين النطاقات بدون فئات (CIDR).

أنواع أخرى من الحدود	القيود والإرشادات
حالة التحقق من سجل MX	وتكون حالة التحقق التلقائي من سجلّات MX هي "خطأ" مما يعني أنّ نظام Google لم يتحقّق مؤخرًا من إعدادات سجلّ MX أو لم يتم ضبط سجلّات MX للتوجيه إلى أنظمة Google. إذا حدَّثت سجلاتك ولا تزال حالة التحقق خطأ، فقد يعني ذلك أنه لم يتم نشر تحديثات سِجل MX، أو أن هناك خطأ إملائيًا في السجل. بالنسبة إلى النشر، نوصي بالانتظار لفترة زمنية محددة بواسطة قيمة مدة البقاء (TTL) لسجل MX ثم إعادة المحاولة.
رموز البلدان	إذا لم يتم تخصيص اسم المؤسسة، فسيكون الاسم الافتراضي هو اسم النطاق الأساسي. للحصول على معلومات عن أحرف اسم المؤسسة، راجع استخدام الأحرف.
الخاصية creationTime وتمثيل رقمي للتواريخ والوقت	يُرجى الاطّلاع على ISO 8601، التمثيل الرقمي للتواريخ والوقت.
علامات ترميز اللغة	راجع علامات لغة RFC 3066 التي يقبلها Google Mail.
اسم المؤسسة	إذا لم يتم تخصيص اسم المؤسسة، فسيكون الاسم الافتراضي هو اسم النطاق الأساسي. للحصول على معلومات عن أحرف اسم المؤسسة، راجع استخدام الأحرف.