تضم Google العديد من المنتجات والخدمات الصحية، بما في ذلك Health Connect. تم إيقاف واجهات Google Fit API نهائيًا وستبقى متاحة حتى 30 حزيران (يونيو) 2025، وبعد هذا التاريخ. توضِّح لك الإرشادات التالية واجهة برمجة التطبيقات أو النظام الأساسي الذي تريد نقل البيانات إليه من كل واجهة من واجهات برمجة تطبيقات Android Fit.
نقل البيانات من Fit Android API إلى Health Connect API
هناك 3 خطوات رئيسية يجب اتّباعها لنقل البيانات إلى Health Connect API.
الخطوة 1: الدمج
الخطوة الأولى لعملية الدمج هي إضافة Health Connect إلى تطبيقك. وسيتضمّن ذلك ما يلي:
- يمكنك الدمج مع تطبيق Health Connect باتّباع خطوات البدء هذه.
- يُرجى توضيح أنواع البيانات ووضع الوصول المطلوبَين في بيان التطبيق.
- عليك الحصول على إذن من المستخدم للوصول إلى Health Connect.
- قراءة/كتابة البيانات وفقًا لحالات الاستخدام المحدّدة أو مهام سير العمل المحدّدة
الخطوة 2: نقل البيانات
ننصحك بإبقاء عمليات دمج واجهة برمجة تطبيقات Google Fit Android API وواجهة برمجة تطبيقات Health Connect API نشطة أثناء نقل بيانات المستخدمين من نظام أساسي إلى آخر. لقد أوقفنا واجهة برمجة التطبيقات Google Fit Android API نهائيًا، إلا أنّنا نهدف إلى إيقافها بحلول 30 حزيران (يونيو) 2025. يمنح ذلك المستخدمين وقتًا كافيًا للانتقال إلى Health Connect ومواصلة استخدام الخدمة.
الخطوة 3: إخلاء مساحة تخزين
اتّبِع الخطوات التالية لإزالة حزمة تطوير البرامج (SDK) الخاصة بتطبيق Google Fit:
- إزالة الرمز المرتبط بـ Google Fit Android API
- أزِل تبعيات "خدمات Google Play".
واجهة برمجة تطبيقات أداة الاستشعار
تتيح لك Sensor API قراءة بيانات أداة الاستشعار الأولية في تطبيقك في الوقت الفعلي. تنفّذ واجهة برمجة تطبيقات Sensor API ما يلي:
- يسرد مصادر البيانات المتوفّرة على الجهاز وعلى الأجهزة المصاحبة.
- تُسجل المستمعين لتلقي بيانات الاستشعار الأولية.
- إلغاء تسجيل أدوات معالجة البيانات حتى لا تتلقّى بيانات أداة الاستشعار الأولية.
نقل البيانات إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية من Sensor API:
| الهاتف | ارتداء الجهاز |
|
استخدام SensorManager وFusedLocationProvider |
استخدام "الخدمات الصحية"
|
واجهة برمجة تطبيقات الجلسة
تمثل الجلسات فاصلاً زمنيًا يمارس خلاله المستخدمون نشاطًا للياقة البدنية.
تسمح واجهة برمجة التطبيقات Session API لتطبيقك بإنشاء جلسات في متجر اللياقة البدنية.
نقل البيانات إلى واجهات برمجة التطبيقات أو المنصّات التالية من Session API:
| الهاتف | ارتداء الجهاز |
|
البدء/الإيقاف: لا ينطبق. يجب أن يتتبّع التطبيق حالة الجلسات الجارية داخليًا. القراءة/الكتابة: استخدام Health Connect. |
بدء/إيقاف: استخدام الخدمات الصحية (ExerciseClient) القراءة/الكتابة: استخدِم Health Connect من خلال تطبيق الأجهزة الجوّالة. بالنسبة إلى مهام سير عمل محددة، ننصحك بما يلي:
|
واجهة برمجة تطبيقات التسجيل
تتيح تسجيل واجهة برمجة التطبيقات لتطبيقك طلب التخزين التلقائي لبيانات جهاز الاستشعار بطريقة فعّالة لاستخدام البطارية من خلال إنشاء الاشتراكات. يرتبط الاشتراك بتطبيق Android ويتكون من نوع من بيانات اللياقة البدنية أو مصدر بيانات محدّد.
نقل البيانات من واجهة برمجة تطبيقات "التسجيل" إلى واجهات برمجة التطبيقات أو المنصّات التالية:
| الهاتف | ارتداء الجهاز |
|
اتّبِع الخطوات التالية لنقل البيانات من Reporting API:
|
استخدام "الخدمات الصحية"
يمكنك الاطّلاع على مستندات "الخدمات الصحية" لمزيد من المعلومات حول الاختلافات بين PassiveMonitoringClient وExerciseClient. |
History API
تسمح واجهة برمجة التطبيقات History API لتطبيقك بإجراء عمليات مجمّعة على متجر اللياقة البدنية، بما في ذلك قراءة بيانات الصحة والعافية السابقة وإدراجها وتحديثها وحذفها.
نقل البيانات إلى واجهات برمجة التطبيقات أو المنصّات التالية من History API:
| الهاتف | ارتداء الجهاز |
|
استخدام Health Connect |
استخدِم Health Connect من تطبيق الأجهزة الجوّالة وليس من الجهاز القابل للارتداء. |
واجهة برمجة التطبيقات الأهداف
الأهداف هي أهداف في تطبيق Google Fit يمكن للمستخدمين ضبطها لأنفسهم. تساعد في تحفيز المستخدمين للحفاظ على نشاطهم كل يوم. من داخل ملفهم الشخصي، يمكن للمستخدمين ضبط عدد الخطوات ونقاط القلب التي يريدون استهدافها كل يوم. تسجِّل منصة Fit أهدافها وتتتبّع نشاطها اليومي وفقًا لهذه الأهداف باستخدام Goals API.
| الهاتف | ارتداء الجهاز |
| لا تتوفّر أي واجهة برمجة تطبيقات بديلة. | لا تتوفّر أي واجهة برمجة تطبيقات بديلة. |
واجهة برمجة تطبيقات BLE
يمكن لتطبيقك العثور على الأجهزة المتاحة التي تتضمّن بلوتوث منخفض الطاقة (BLE) وإدراج بيانات الاستشعار في نظام Google Fit الأساسي باستخدام واجهة برمجة تطبيقات BLE API.
نقل البيانات من واجهة برمجة تطبيقات BLE API إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية:
| الهاتف | ارتداء الجهاز |
| يمكنك استخدام واجهات برمجة تطبيقات بلوتوث Android مباشرةً. | يمكنك استخدام واجهات برمجة تطبيقات بلوتوث Android مباشرةً. |