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

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

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

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

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

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

الحدود

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

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

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