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

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

تعذُّر طلب البيانات من واجهة برمجة التطبيقات

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

أخطاء مستندة إلى الوقت

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

الحدود القصوى المسموح بها

فئات حدود واجهة برمجة التطبيقات	الحدود القصوى المسموح بها
الاشتراك purchaseOrderId	تقبل هذه السمة ما يصل إلى 80 حرفًا من أحرف النص العادي.
الاشتراك maxResults	يمكن أن تتألّف سلسلة طلب البحث maxResults من 1 إلى 100 نتيجة. العدد التلقائي هو 20 نتيجة.
الرمز المميّز للنقل (customerAuthToken)	يكون الرمز المميّز للنقل الخاص بالعميل صالحًا لمدة 30 يومًا بعد إنشائه.
الحدّ الأقصى لعدد المستخدمين للعميل	واستنادًا إلى عقدك، يمكن أن يبلغ الحدّ الأقصى لعدد المستخدمين 50,000 مستخدم أو الحدّ الأقصى المحدَّد في عقد المورّد.
الطلبات غير المصرّح بها	لا تسمح Google بالطلبات غير المصرّح بها إلى واجهة برمجة تطبيقات المورّد. يُعتبر الطلب غير مصرَّح به في حال عدم تقديم رمز مميّز للتفويض. يُرجى الاطّلاع على مزيد من المعلومات حول المصادقة والترخيص.

الأنواع الأخرى من الحدود

الأنواع الأخرى من الحدود	القيود والإرشادات
تنسيق البيانات	يكون تنسيق البيانات بتنسيق JavaScript Object Notation JSON. JSON هو تنسيق شائع على الإنترنت يوفّر طريقة لتمثيل بُنى البيانات العشوائية. وJSON هو تنسيق نصي مستقل تمامًا عن اللغة، ولكنّه يستخدم اصطلاحات مألوفة للمبرمجين في مجموعة اللغات C، بما في ذلك C وC++ وC# وJava وJavaScript وPerl وPython.
تنسيق الوقت	وتظهر جميع الأوقات في محوّل Epoch بالمللي ثانية. ينطبق هذا التنسيق على قيم وقت إنشاء الاشتراك، ووقت بدء الاشتراك وانتهائه في الخطة، ووقت انتهاء الفترة التجريبية المجانية لمدة 30 يومًا.