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