تحمي الحدود والحصص بنية Google الأساسية من عملية تلقائية تستخدم واجهة برمجة التطبيقات لإعدادات المشرف بطريقة غير ملائمة. قد تنتج الطلبات المفرطة من واجهة برمجة التطبيقات عن خطأ إملائي غير ضار، أو قد تنتج عن نظام مصمّم بشكل غير فعّال يُجري طلبات غير ضرورية من واجهة برمجة التطبيقات. بغض النظر عن السبب، من الضروري حظر الزيارات من مصدر معيّن عند بلوغها مستوى معيّنًا للحفاظ على سلامة نظام Google Workspace بشكل عام. ويضمن ذلك ألا تؤثر إجراءات أحد المطوّرين سلبًا على المنتدى الأكبر.
في حال تعذّر إكمال طلب بيانات من واجهة برمجة التطبيقات، وهو أمر غير مرجّح، ستتلقّى استجابة رمز حالة HTTP. يحتوي رمز الحالة 403 على معلومات خطأ بشأن الإدخال غير الصحيح، ويحتوي رمز حالة HTTP 503 على معلومات خطأ تشير إلى الحصص التي تم تجاوزها في واجهة برمجة التطبيقات. تسمح هذه الاستجابات لتطبيقك المخصّص برصد هذه الأخطاء واتخاذ الإجراء المناسب.
إذا كان يجب إكمال طلباتك خلال فترة زمنية محدّدة، أرسِل طلباتك بالتوازي أو استخدِم سلاسل تنفيذ متعدّدة في تطبيق Java أو C#. على سبيل المثال، قسِّم طلباتك حسب الشهر أو فترة زمنية أخرى. في ما يتعلق بسلاسل التنفيذ، جرِّب البدء بـ 10 سلاسل تنفيذ، أي سلسلة تنفيذ واحدة لكل طلب. ملاحظة: إنّ اقتراح سلاسل التنفيذ له جوانب إيجابية وسلبية ولا يكون مفيدًا في جميع حالات واجهة برمجة التطبيقات. إذا أصبح عدد الطلبات مرتفعًا جدًا، ستحدث أخطاء في الحصة.
بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (الحد الأقصى لعدد N من العناصر لمدة X من الثواني لكل سلسلة تنفيذ)، وخاصةً أخطاء رمز الحالة 503، ننصحك بأن يرصد الرمز الاستثناء، وأن ينتظر فترة تأخير قصيرة قبل إعادة محاولة إجراء المكالمة التي تعذّر إجراؤها، وذلك باستخدام خوارزمية التراجع الأسي. أحد الأمثلة على واجهة برمجة التطبيقات لإعدادات البريد الإلكتروني لسلسلة تنفيذ واحدة هو الانتظار لمدة 5 ثوانٍ وإعادة محاولة إجراء المكالمة التي تعذّر إجراؤها. إذا نجح الطلب، كرِّر هذا النمط لسلاسل التنفيذ الأخرى. إذا لم ينجح الطلب الثاني، يجب أن يقلّل تطبيقك من وتيرة الطلب إلى أن تنجح إحدى المكالمات. على سبيل المثال، يمكنك زيادة فترة التأخير الأولية من 5 ثوانٍ إلى 10 ثوانٍ وإعادة محاولة إجراء المكالمة التي تعذّر إجراؤها مرة أخرى. عليك أيضًا تحديد حدّ لإعادة المحاولة. على سبيل المثال، يمكنك إعادة محاولة إجراء طلب من 5 إلى 7 مرات مع فترات تأخير مختلفة قبل أن يعرض تطبيقك خطأً للمستخدم.
| فئات حصص واجهة برمجة التطبيقات | الحصص |
|---|---|
| رموز مصادقة ClientLogin | صالحة لمدة 24 ساعة. الخطأ هو "401 انتهت صلاحية الرمز". |
| إنشاء مفاتيح عامة وخاصة |
باستخدام موفّر الهوية، يمكنك إنشاء مجموعة من المفاتيح العامة والخاصة باستخدام خوارزميات DSA أو RSA. المفتاح العام هو شهادة بتنسيق X.509. لمزيد من المعلومات حول مفاتيح التوقيع الخاصة بخدمة الدخول الموحَّد المستندة إلى SAML، يُرجى الاطّلاع على مقالة إنشاء المفاتيح والشهادات لخدمة الدخول الموحَّد في Google Workspace. |
| Logo |
يمكن أن يكون ملف صورة شعار الحساب بتنسيق JPEG أو PNG أو GIF. الحجم المقترَح هو 143 × 59 بكسل ويجب أن يكون حجم الملف أقل من 20 كيلوبايت. عند استخدام الشعارات المخصّصة، يُرجى الالتزام ببنود خدمة Google Terms of Service. ويُرجى عدم استخدام شعار Google أو شعار Gmail شعار أو أي شعارات أخرى لشركة Google. لمزيد من المعلومات، يُرجى الاطّلاع على سياسات الشعارات والصفحات المقصودة. |
| ssoWhitelist |
إنّ ssoWhitelist هو عنوان IP لقناع شبكة بتنسيق التوجيه بين النطاقات بدون فئات (CIDR). |
| أنواع الحدود الأخرى | القيود والإرشادات |
|---|---|
| حالة إثبات صحة سجلّ MX |
تكون حالة إثبات صحة سجلّ MX التلقائية هي `false`، ما يعني أنّ نظام Google لم يتحقّق مؤخرًا من إعداد سجلّ MX أو لم يتم ضبط سجلّات MX للتوجيه إلى أنظمة Google. إذا عدّلت سجلّاتك وظلّت حالة إثبات صحة سجلّ MX هي `false`، قد يعني ذلك أنّه لم يتم نشر تعديلات سجلّ MX أو أنّ هناك خطأ إملائيًا في السجلّ. لنشر التعديلات، ننصحك بالانتظار للمدة الزمنية المحدّدة في قيمة "المدة المتبقية" (TTL) لسجلّ MX، ثم إعادة المحاولة. |
| رموز البلدان |
إذا لم يتم تخصيص اسم المؤسسة، يكون الاسم التلقائي هو اسم نطاقك الأساسي. للحصول على معلومات حول أحرف اسم المؤسسة، يُرجى الاطّلاع على مقالة استخدام الأحرف. |
السمة creationTime، التمثيل العددي للتاريخ والوقت |
يُرجى الاطّلاع على مقالة ISO 8601، التمثيل العددي للتاريخ والوقت. |
| علامات ترميز اللغة |
يُرجى الاطّلاع على علامات اللغة RFC 3066 التي يقبلها Google Mail. |
| اسم المؤسسة |
إذا لم يتم تخصيص اسم المؤسسة، يكون الاسم التلقائي هو اسم نطاقك الأساسي. للحصول على معلومات حول أحرف اسم المؤسسة، يُرجى الاطّلاع على مقالة استخدام الأحرف. |
طلب زيادة الحصة لكل مشروع
بناءً على استخدام مشروعك للموارد، قد تحتاج إلى طلب تعديل الحصة تُعتبَر طلبات واجهة برمجة التطبيقات التي يُجريها حساب خدمة مستخدِمة حسابًا واحدًا. لا يضمن التقدم بطلب للحصول على حصة معدّلة الموافقة. قد تستغرق طلبات تعديل الحصة التي ستزيد قيمة الحصة بشكل ملحوظ وقتًا أطول للموافقة عليها.
لا تتساوى الحصص في جميع المشاريع. مع زيادة استخدامك لـ Google Cloud بمرور الوقت، قد تحتاج إلى زيادة قيم الحصص. إذا كنت تتوقّع زيادة ملحوظة في الاستخدام في المستقبل القريب، يمكنك طلب تعديلات الحصة بشكل استباقي من صفحة "الحصص" في Google Cloud Console.
لمزيد من المعلومات، يُرجى الاطّلاع على المَراجع التالية: