الحدود والحصص

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

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

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

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

فئات حصة واجهة برمجة التطبيقات	الحصص
طلبات البحث في الثانية (QPS)	حصة عدد الطلبات في الثانية هي 1.

فئات حدود واجهة برمجة التطبيقات	الحدود القصوى المسموح بها
سلسلة طلب maxResults	الحد الأقصى لحجم النتائج القصوى هو 100.

الأنواع الأخرى من الحدود	القيود والإرشادات
الطلبات المجمّعة	تتيح واجهة برمجة التطبيقات إرسال الطلبات المجمّعة.
تنسيق البيانات في ردود واجهة برمجة التطبيقات	يكون تنسيق بيانات الردّ هو JavaScript Object Notation (JSON).
تفعيل واجهة برمجة تطبيقات إدارة تراخيص Enterprise	يجب تفعيل "واجهة برمجة التطبيقات لإدارة التراخيص" قبل إجراء اتصالات بواجهة برمجة تطبيقات إدارة تراخيص Enterprise. في لوحة التحكم، انتقل إلى صفحة الإعدادات في علامة التبويب "المستخدمون والمجموعات"، ومكِّن واجهة برمجة التطبيقات لإدارة الحسابات. احفظ التغييرات. بالإضافة إلى ذلك، يجب أن يتم تفعيل خدمة "مجموعات Google" وتفعيلها.
الطلبات غير المصرّح بها	لا تقبل واجهة برمجة التطبيقات أي طلبات غير مصرّح بها. يُعتبر الطلب غير مصرَّح به في حال عدم تقديم رمز مميّز للتفويض. لمزيد من المعلومات، يُرجى الاطّلاع على تفويض الطلبات.