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

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

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

يوضح الجدول التالي بالتفصيل حدود طلبات البحث:

الحصص
قراءة الطلبات
في الدقيقة لكل مشروع 6000
في الدقيقة لكل مستخدم في كل مشروع 600
كتابة الطلبات
في الدقيقة لكل مشروع 1,000
في الدقيقة لكل مستخدم في كل مشروع 100
انخفاض طلبات الكتابة

(يتم استخدامه لطلبات spaces.create.)

في الدقيقة لكل مشروع 100
في الدقيقة لكل مستخدم في كل مشروع 10

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

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

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

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

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

  1. يمكنك تقديم طلب إلى Google Meet API.
  2. إذا تعذّر إجراء الطلب، انتظر 1 + random_number_milliseconds ثم أعِد محاولة الطلب.
  3. وإذا تعذّر إجراء الطلب، انتظِر 2 + random_number_milliseconds ثم أعِد محاولة الطلب.
  4. وإذا تعذّر إجراء الطلب، انتظِر لمدة 4 + random_number_milliseconds ثم أعِد محاولة الطلب.
  5. وهكذا، حتى مرة واحدة (maximum_backoff).
  6. يمكنك مواصلة الانتظار وإعادة المحاولة لتصل إلى الحد الأقصى المسموح به لعدد عمليات إعادة المحاولة، ولكن مع عدم زيادة فترة الانتظار بين عمليات إعادة المحاولة.

المكان:

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

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

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

السعر

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

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

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

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

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