تعمل الحدود والحصص على حماية بنية Google الأساسية من عملية تلقائية تستخدم Reseller API بطريقة غير ملائمة. قد تنتج الطلبات الزائدة من واجهة برمجة التطبيقات عن خطأ إملائي غير ضار، أو قد تنتج عن نظامٍ مُصمَّم بطريقة غير فعّالة يُجري طلبات بيانات من واجهة برمجة التطبيقات بدون داعٍ. بغض النظر عن السبب، فإنّه يجب حظر عدد الزيارات الواردة من مصدر معيّن عند وصوله إلى مستوى معيّن للحفاظ على الحالة العامة لنظام Google Workspace. ويضمن ذلك أنّه لا يمكن أن تؤثّر تصرفات مطوّر واحد سلبًا في المجتمع الأوسع نطاقًا.
تعذُّر طلبات البيانات من واجهة برمجة التطبيقات
في حال حدوث خطأ في طلبك من واجهة برمجة التطبيقات، سيتلقّى تطبيقك
استجابة رمز حالة HTTP. يتضمّن رمز الحالة 403 معلومات خطأ
حول الإدخال غير الصحيح، ويتضمّن رمز حالة HTTP 503
معلومات خطأ تشير إلى الحصص التي تم تجاوزها في واجهة برمجة التطبيقات. تتيح هذه
الاستجابات لتطبيقك المخصّص رصد هذه الأخطاء واتّخاذ الإجراء المناسب.
الأخطاء المستندة إلى الوقت
بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (ما يصل إلى N عمليات في N ثوانٍ لكل سلسلسة مهام)، خاصةً أخطاء رمز الحالة 503، ننصحك بأن يرصد رمزك الاستثناء، ومن خلال استخدام خوارزمية التوقف المؤقت المتزايد، انتظِر تأخيرًا صغيرًا قبل إعادة محاولة طلب البيانات الذي تعذّر إكماله. مثال على
Reseller API لسلسلة محادثات واحدة
هو الانتظار لمدة 5 ثوانٍ وإعادة محاولة طلب البيانات الذي تعذّر تنفيذه. إذا نجح الطلب، تكرِّر
هذا النمط لسلاسل المحادثات الأخرى. إذا لم يكن الطلب الثاني
ناجحًا، من المفترض أن يقلّل تطبيقك من معدّل تكرار الطلب
إلى أن يتم إجراء مكالمة ناجحة. على سبيل المثال، يمكنك زيادة فترة الانتظار الأولية التي تبلغ 5 ثوانٍ
إلى 10 ثوانٍ وإعادة محاولة إجراء المكالمة التي تعذّر إجراؤها. حدِّد أيضًا عدد مرات إعادة المحاولة.
على سبيل المثال، يمكنك إعادة محاولة إرسال طلب من 5 إلى 7 مرات بفترات تأخير مختلفة قبل أن يعرض
تطبيقك خطأ للمستخدم.
الحدود
| فئات حدود واجهة برمجة التطبيقات | الحدود |
|---|---|
الاشتراك purchaseOrderId |
تقبل هذه السمة ما يصل إلى 80 حرفًا من النص العادي. |
الاشتراك maxResults |
يمكن أن تتضمّن سلسلة طلب البحث maxResults من 1 إلى 100 نتيجة.
القيمة التلقائية هي 20 نتيجة.
|
الرمز المميّز للنقل (customerAuthToken) |
تبقى رمز النقل الخاص بالعميل صالحًا لمدة 30 يومًا من إنشائه. |
| الحد الأقصى لعدد المستخدمين للعميل | استنادًا إلى عقدك، يمكن أن يكون الحد الأقصى لعدد المستخدمين هو 50,000 مستخدم أو الحد الأقصى المحدّد في عقد المورّد. |
| الطلبات غير المصرّح بها | لا تسمح Google بطلبات غير مصرَّح بها إلى Reseller API. يُعتبر الطلب غير مصرّح به في حال عدم تقديم رمز مميّز للتفويض. لمزيد من المعلومات، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض. |
أنواع أخرى من الحدود
| أنواع أخرى من الحدود | القيود والإرشادات |
|---|---|
| تنسيق البيانات |
تنسيق البيانات بتنسيق JavaScript Object Notation
JSON
JSON هو تنسيق شائع على الإنترنت يقدّم طريقة لتمثيل بنى البيانات العشوائية. JSON هو تنسيق نصي لا يعتمد على اللغة تمامًا، ولكنه يستخدم اصطلاحات مألوفة لمبرمجي عائلة لغات C، بما في ذلك C وC++ وC# وJava وJavaScript وPerl وPython. |
| تنسيق الوقت | يتم عرض جميع تواريخ الأوقات في محوِّل الحقبة بالملي ثانية. ينطبق هذا التنسيق على قيم وقت إنشاء الاشتراك ووقتَي بدء ونهاية التزام الخطة ووقت انتهاء المدة التجريبية مجانًا التي تبلغ 30 يومًا. |