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