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

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

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

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

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

فئات حصص واجهة برمجة التطبيقات الحصص
رموز المصادقة المميزة في ClientLogin صالحة لمدة 24 ساعة. الخطأ هو "401 token expired".
إنشاء مفتاحَي تشفير عام وخاص

أنشئ مجموعة من المفاتيح العامة والخاصة باستخدام خوارزميات DSA أو RSA مع موفّر خدمة تحديد الهوية. يكون المفتاح العام في شهادة منسَّقة بمعيار X.509. لمزيد من المعلومات حول مفاتيح التوقيع الخاصة بخدمة الدخول الموحّد المستندة إلى SAML، يُرجى الاطّلاع على إنشاء مفاتيح وشهادات لخدمة الدخول الموحّد في Google Workspace.
Logo

يمكن أن يكون ملف صورة شعار الحساب بتنسيق JPEG أو PNG أو GIF. الحجم المقترَح هو 143 × 59 بكسل ويجب أن يكون حجم الملف أقل من 20 كيلوبايت. عند استخدام شعارات مخصّصة، يُرجى الالتزام ببنود خدمة Google. ويجب عدم استخدام شعار Google أو شعار Gmail أو أي شعارات أخرى لشركة Google. لمزيد من المعلومات، يُرجى الاطّلاع على سياسات الشعارات والصفحات المقصودة.
ssoWhitelist

قائمة ssoWhitelist هي عنوان IP لقناع شبكة بتنسيق التوجيه بين النطاقات بدون فئات(CIDR).
أنواع أخرى من الحدود القيود والإرشادات
حالة التحقّق من سجلّ MX

تكون حالة إثبات ملكية سجلّ MX التلقائية هي `false`، ما يعني أنّ نظام Google لم يتحقّق مؤخرًا من إعدادات سجلّ MX أو لم يتم ضبط سجلّات MX للتوجيه إلى أنظمة Google. إذا عدّلت سجلّاتك وظلّت حالة التحقّق غير صحيحة، قد يعني ذلك أنّه لم يتم نشر تعديلات سجلّ MX أو أنّ هناك خطأ إملائيًا في السجلّ. لإتمام عملية النشر، ننصحك بالانتظار للمدة الزمنية المحدّدة في قيمة Time To Live (TTL) لسجل MX ثم إعادة المحاولة.
رموز البلدان

إذا لم يتم تخصيص اسم المؤسسة، سيكون الاسم التلقائي هو اسم نطاقك الأساسي. للحصول على معلومات حول أحرف اسم المؤسسة، يُرجى الاطّلاع على استخدام الأحرف.
السمة creationTime، التمثيل الرقمي للتواريخ والأوقات

راجِع ISO 8601، التمثيل الرقمي للتاريخ والوقت.
علامات ترميز اللغة

اطّلِع على علامات اللغة RFC 3066المقبولة في Google Mail.
اسم المؤسسة

إذا لم يتم تخصيص اسم المؤسسة، سيكون الاسم التلقائي هو اسم نطاقك الأساسي. للحصول على معلومات حول أحرف اسم المؤسسة، يُرجى الاطّلاع على استخدام الأحرف.

طلب زيادة الحصة لكل مشروع

بناءً على استخدامك للموارد في مشروعك، قد تحتاج إلى طلب تعديل الحصة. يُعتبَر أنّ طلبات البيانات من واجهة برمجة التطبيقات التي يرسلها حساب خدمة تستخدم حسابًا واحدًا. لا يضمن التقدم بطلب للحصول على حصة معدَّلة الموافقة. قد تستغرق طلبات تعديل الحصة التي تؤدي إلى زيادة كبيرة في قيمة الحصة وقتًا أطول للموافقة عليها.

لا تتساوى جميع المشاريع في الحصص. مع زيادة استخدامك لخدمات Google Cloud بمرور الوقت، قد تحتاج إلى زيادة قيم الحصة. إذا كنت تتوقّع زيادة ملحوظة في الاستخدام في المستقبل القريب، يمكنك بشكل استباقي طلب تعديلات على الحصة من صفحة الحصص في Google Cloud Console.

لمزيد من المعلومات، يُرجى الاطّلاع على المراجع التالية: