للحفاظ على استقرار النظام وأدائه المثاليين، يفرض تطبيق Health Connect حدودًا على معدّلات الاتصال بالعميل بواجهة برمجة تطبيقات Health Connect.
يوضّح هذا الدليل الحدود المفروضة على عمليات قراءة وكتابة واجهة برمجة التطبيقات في تطبيق Health Connect، وكيفية تجنُّب تحديد معدّل الزحف من خلال تصميم التطبيق الفعّال.
حدود واجهة برمجة التطبيقات
ويتم وضع الحدود في كل من عمليات واجهة برمجة التطبيقات التي تعمل في المقدّمة والخلفية باعتبارها حصصًا ثابتة لمعدّل الطلبات.
تتغير حدود الذاكرة ومعدّل السرعة بناءً على نوع العملية التي ينفّذها تطبيقك، وما إذا كانت هذه العملية تحدث في المقدّمة أو في الخلفية.
حدود القراءة وسجلّ التغييرات
بالنسبة إلى حدود القراءة وسجلّ التغييرات، يفرض تطبيق Health Connect حدَّين على عدد طلبات البيانات من واجهة برمجة التطبيقات المتاحة لتطبيقك:
- حدّ دوري لعدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكن لتطبيقك إجراؤها من واجهة برمجة التطبيقات
- حدّ يومي لعدد طلبات البيانات من واجهة برمجة التطبيقات التي يمكن لتطبيقك إجراؤها.
إدراج الحدود وتعديلها وحذفها
يضع Health Connect أربعة قيود مختلفة على عمليات الإدراج والتحديث والحذف:
- حد دوري لعدد الاتصالات التي يمكن لتطبيقك إجراؤها بواجهة برمجة التطبيقات.
- حدّ يومي لعدد الاتصالات التي يمكن لتطبيقك إجراؤها بواجهة برمجة التطبيقات.
- حد الذاكرة للإدراج المجمَّع.
- حدّ الذاكرة لعمليات إدراج سجلّ واحد
أفضل الممارسات
نقترح أن تتفاعل التطبيقات مع Health Connect API بطريقة تقلّل من استهلاك البطارية وتحافظ على صحة النظام الأمثل وتعزز الإدارة الفعّالة للبيانات في جميع عمليات CRUD.
في ما يلي بعض الإرشادات حول أفضل الممارسات التي يجب التقيّد بها.
طلبات بيانات من واجهة برمجة التطبيقات في الخلفية
يقلل استخدام البطارية للعمليات في الخلفية من تجربة المستخدم ويثير أسئلة بشأن خصوصية البيانات.
وبالتالي، يكون تقييد معدّل الخلفية أكثر صرامة من تقييد معدّل المقدّمة في المقدّمة. لذا، من المهم الحدّ من مقدار طلبات البيانات من واجهة برمجة التطبيقات التي يجريها تطبيقك في الخلفية.
التعامل مع الاستثناء
إذا واجه تطبيقك استثناءً عند كتابة البيانات في Health Connect، ننصحك بإعادة المحاولة من مكان الاستثناء.
يجب عدم حذف جميع البيانات المعنيّة وإعادة محاولة طلب الكتابة بالكامل. يؤثر هذا الأسلوب سلبًا في حصة الإدخال ويقلل من الأداء، كما يؤثر سلبًا في عمر البطارية.
التعامل مع سجلّ التغييرات
للحدّ من خطر فرض قيود على معدّل استخدام تطبيقك، عليك استخدام معالجة سجلّ التغييرات لمزامنة قاعدة بياناتك مع البيانات من Health Connect، بدلاً من الاعتماد بشكل مفرط على طلبات القراءة الأولية.