حدود الاستخدام

بما أنّ Google Forms API هي خدمة مشترَكة، نطبّق حصصًا وقيودًا للتأكّد من استخدامها بشكل عادل من قِبل جميع المستخدمين وحماية الحالة العامة لنظام Google Workspace.

إذا تجاوزت حصة، ستتلقّى عادةً استجابة 429: Too many requests رمز حالة HTTP. إذا حدث ذلك، عليك استخدام خوارزمية التراجع الأسي وإعادة المحاولة لاحقًا. ما دامت الطلبات ضمن الحصص المحدّدة لكل دقيقة أدناه، ليس هناك حدّ أقصى لعدد الطلبات التي يمكنك إجراؤها يوميًا.

ملاحظة: تفرض ساعات النماذج حدودًا إضافية. اطّلِع على مقالة إعداد الإشعارات الفورية وتلقّيها للحصول على مزيد من المعلومات.

يوضّح الجدول التالي حدود الطلبات:

الحصص
قراءة الطلبات
لكل يوم لكل مشروع غير محدودة
في الدقيقة لكل مشروع 975
لكل دقيقة لكل مستخدم لكل مشروع 390
طلبات القراءة ذات التكلفة العالية

(يُستخدَم لطلبات forms.responses.list.)

لكل يوم لكل مشروع غير محدودة
في الدقيقة لكل مشروع 450
لكل دقيقة لكل مستخدم لكل مشروع 180
كتابة الطلبات
لكل يوم لكل مشروع غير محدودة
في الدقيقة لكل مشروع 375
لكل دقيقة لكل مستخدم لكل مشروع 150

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

بالنسبة إلى جميع الأخطاء المستندة إلى الوقت (الحد الأقصى لطلبات N كل X دقائق)، ننصح بأن يرصد الرمز البرمجي الاستثناء ويستخدم وقت انتظار متزايد مقطوع للتأكّد من عدم توليد أجهزتك لحمل زائد.

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

مثال على الخوارزمية

تعيد خوارزمية التراجع الأسي الطلبات بشكلٍ أسي، ما يؤدي إلى زيادة وقت الانتظار بين عمليات إعادة المحاولة إلى الحد الأقصى لوقت التراجع. على سبيل المثال:

  1. قدِّم طلبًا إلى Google Forms API.
  2. إذا تعذّر إكمال الطلب، انتظِر random_number_milliseconds ثانية ثم أعِد محاولة إكماله.
  3. إذا تعذّر إكمال الطلب، انتظِر random_number_milliseconds ثانية أو أكثر وأعِد محاولة إكماله.
  4. إذا تعذّر إكمال الطلب، انتظِر 4 ثوانٍ أو أكثر ثم أعِد محاولة إكماله.random_number_milliseconds
  5. وهكذا دواليك، حتى maximum_backoff مرة.
  6. يُرجى الانتظار وإعادة المحاولة حتى الحد الأقصى لعدد مرات إعادة المحاولة، ولكن لا تزيد مدّة الانتظار بين عمليات إعادة المحاولة.

حيث:

  • يبلغ وقت الانتظار min(((2^n)+random_number_milliseconds), maximum_backoff)، مع زيادة n بمقدار 1 لكل تكرار (طلب).
  • ‫random_number_milliseconds هو عدد عشوائي بالمللي ثانية أقل من أو يساوي 1,000. يساعد ذلك في تجنُّب الحالات التي تتم فيها مزامنة العديد من العملاء نتيجةً لموقف معيّن وإعادة المحاولة كلها مرة واحدة، وإرسال الطلبات في موجات تتم مزامنتها مع بعضها. تتم إعادة احتساب قيمة random_number_milliseconds بعد كل طلب إعادة محاولة.
  • تكون مدة maximum_backoff عادةً 32 أو 64 ثانية. تعتمد القيمة المناسبة على حالة الاستخدام.

يمكن للعميل مواصلة إعادة المحاولة بعد بلوغ الوقت maximum_backoff. لا تحتاج عمليات إعادة المحاولة بعد هذه المرحلة إلى مواصلة زيادة وقت الانتظار. على سبيل المثال، إذا كان العميل يستخدم وقت maximum_backoff مدته 64 ثانية، بعد الوصول إلى هذه القيمة، يمكن للعميل إعادة المحاولة كل 64 ثانية. في مرحلة ما، يجب منع العملاء من إعادة المحاولة إلى أجل غير مسمى.

يعتمد وقت الانتظار بين عمليات إعادة المحاولة وعدد عمليات إعادة المحاولة على حالة الاستخدام وظروف الشبكة.

التسعير

يمكنك استخدام Google Forms API بدون أي تكلفة إضافية. لا يؤدي تجاوز الحصة أو حدود الطلبات إلى تحمُّل رسوم إضافية ولا يتمّ تحصيل رسوم من حسابك.

طلب زيادة في الحصة

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

لا تتوفّر الحصص نفسها في جميع المشاريع. مع زيادة استخدامك لخدمة Google Cloud بمرور الزمن، قد تحتاج إلى زيادة حصصك. إذا كنت تتوقّع تسجيل زيادة ملحوظة في الاستخدام في المستقبل، يمكنك بشكل استباقي طلب تعديلات على الحصص من صفحة "الحصص" في Google Cloud Console.

لمزيد من المعلومات، يُرجى الاطّلاع على المراجع التالية: