لضمان استقرار النظام وتوزيع الموارد بشكل عادل، تفرض واجهة Google Health API حدودًا على معدّل طلبات البيانات الواردة من واجهة برمجة التطبيقات.
على الرغم من أنّ الحصص التلقائية مصمّمة لتلبية الغالبية العظمى من حالات الاستخدام العادية، سيتم تقييد التطبيقات التي تتجاوز هذه الحدود.
التعامل مع أخطاء الحدّ الأقصى للمعدّل والأخطاء العابرة
عندما يتجاوز تطبيقك الحدّ الأقصى المخصّص للمعدّل، ترفض واجهة برمجة التطبيقات
الطلب وتعرض الخطأ 429 Too Many Requests (RESOURCE_EXHAUSTED). يمكن أن تؤدي أيضًا مشاكل الخادم
المؤقتة إلى عرض الخطأ 503 Service Unavailable (UNAVAILABLE) أو
504 Gateway Timeout (DEADLINE_EXCEEDED).
للتعامل مع هذه الردود بشكل موثوق بدون زيادة الحمل، يمكنك تنفيذ منطق إعادة المحاولة مع التراجع الأسي والتفاوت العشوائي في الردود 429 RESOURCE_EXHAUSTED و503 UNAVAILABLE و504 DEADLINE_EXCEEDED. تجنَّب إعادة المحاولة فورًا، لأنّ ذلك يؤدي إلى تفاقم الازدحام وزيادة تكرار عمليات التقييد أو انتهاء المهلة.
الحدود القصوى التلقائية وتحليل التأثير
يتم تقييم حدود المعدّل على فترات يومية ودقيقة ولكل مستخدم. يوضّح تحليل التأثير كيفية ترجمة هذه الحصص إلى طلبات في الثانية (QPS).
| المقياس | الحدّ التلقائي | تحليل تأثير طلبات البحث في الثانية |
|---|---|---|
| لكل مشروع (يوميًا) | 86.4 مليون طلب في اليوم | ~1,000 طلب في الثانية بشكل مستمر |
| لكل مشروع (في الدقيقة) | 120,000 طلب في الدقيقة | ~2,000 طلب في الثانية كحدّ أقصى |
| لكل مستخدم (في الدقيقة) | 300 طلب في الدقيقة | الإصدار العادي: 5 طلبات في الثانية لكل مستخدم التطبيقات التي لم يتم التحقّق منها: 250 طلبًا في الثانية كحد أقصى (بحد أقصى 100 مستخدم بمعدل 2.5 طلب في الثانية لكل مستخدم) |
الحدود القصوى لمعدّل منح الرموز المميّزة لبروتوكول OAuth
تفرض Google Cloud حدًّا لمعدّل منح الرموز المميّزة لبروتوكول OAuth من أجل التحكّم في سرعة إعداد المستخدمين أو إعادة مصادقتهم في تطبيقك. إذا كنت تتوقّع تجاوز 10,000 عملية تسجيل مستخدم أو إعادة مصادقة خلال فترة زمنية متغيرة مدتها 24 ساعة، اطلب حصة أعلى مسبقًا. لمزيد من المعلومات، يُرجى الاطّلاع على الحدود القصوى لمعدّل طلبات تطبيقات OAuth.طلب زيادة الحصة
إذا كان تطبيقك يتطلّب معدّل نقل بيانات أعلى من الحصص التلقائية المقدَّمة، يمكنك طلب تعديل من خلال Google Cloud Console. يُرجى الاطّلاع على عرض الحصص وإدارتها.