دليل نقل البيانات

توفّر Google العديد من المنتجات والخدمات الصحية في مجموعة منتجاتها، بما في ذلك Health Connect. تم إيقاف واجهات برمجة تطبيقات Google Fit نهائيًا، وستظل متاحةً حتى 2026، عندما سيتم إيقافها. توضِّح لك الإرشادات التالية واجهة برمجة التطبيقات أو المنصة التي يجب نقل البيانات إليها من كل واجهة برمجة تطبيقات Google Fit Android API.

نقل البيانات من 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، نهدف إلى إيقاف واجهة برمجة التطبيقات في موعد أقصاه 2026. ويهدف ذلك إلى منح المستخدمين الوقت الكافي للتبديل إلى Health Connect ومواصلة الخدمة.

الخطوة 3: التنظيف

اتّبِع الخطوات التالية لإزالة حِزمة تطوير البرامج (SDK) من Google Fit:

  1. أزِل الرمز المرتبط لواجهة برمجة التطبيقات Google Fit Android API.
  2. أزِل التبعيات لـ "خدمات Google Play".

Sensor API

تتيح لك Sensor API قراءة بيانات أجهزة الاستشعار الأوّلية في تطبيقك في الوقت الفعلي. تُجري واجهة برمجة التطبيقات Sensor API ما يلي:

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

يمكنك نقل البيانات من Sensor API إلى واجهات برمجة التطبيقات أو المنصات التالية:

الهاتف Wear

استخدام SensorManager وFusedLocationProvider

استخدام "خدمات الصحة"

  • PassiveMonitoringClient
  • MeasureClient
  • ExerciseClient

    أو استخدِم SensorManager وFusedLocationProvider.

Session API

تمثّل الجلسات فاصلاً زمنيًا يمارس خلاله المستخدِمون نشاطًا لياقة بدنية.

تتيح واجهة برمجة التطبيقات Session API لتطبيقك إنشاء جلسات في متجر اللياقة البدنية.

انتقِل إلى واجهات برمجة التطبيقات أو المنصّات التالية من Session API:

الهاتف Wear

بدء/إيقاف: لا ينطبق. يجب أن يتتبّع التطبيق حالة جلسات العميل الجارية من الداخل.

القراءة/الكتابة: استخدِم Health Connect.

بدء/إيقاف: استخدام خدمات الصحة (ExerciseClient)

القراءة/الكتابة: استخدام Health Connect من خلال تطبيق متوافق مع الأجهزة الجوّالة

بالنسبة إلى عمليات سير العمل المحدّدة، ننصح بما يلي:

  • إدراج جلسة: على المطوّرين استخدام Health Connect من خلال تطبيق جوّال وإدراج سجلّ جلسة تمرين أو سجلّ جلسة نوم وفقًا لذلك.

Recording API

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

انقل بياناتك من Recording API إلى واجهات برمجة التطبيقات أو المنصات التالية:

الهاتف Wear

اتّبِع الخطوات التالية لنقل البيانات من Recording API:

  1. تنفيذ عملية تسجيل البيانات باستخدام واجهة برمجة التطبيقات Recording API على الأجهزة الجوّالة
  2. كتابة البيانات التي تم تسجيلها في Health Connect أو قاعدة بيانات تطبيقك

استخدام "خدمات الصحة"

  • PassiveMonitoringClient
  • ExerciseClient

اطّلِع على مستندات الخدمات الصحية للاطّلاع على مزيد من المعلومات حول الاختلافات بين PassiveMonitoringClient وExerciseClient.

History API

تتيح واجهة برمجة التطبيقات History API لتطبيقك تنفيذ عمليات مجمّعة في "متجر اللياقة البدنية"، بما في ذلك قراءة بيانات الصحة والعافية السابقة وإدراجها وتعديلها وحذفها.

يمكنك نقل البيانات من History API إلى واجهات برمجة التطبيقات أو المنصّات التالية:

الهاتف Wear

استخدام Health Connect

استخدِم Health Connect من التطبيق المتوافق مع الأجهزة الجوّالة وليس من الجهاز القابل للارتداء.

Goals API

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

الهاتف Wear
لا تتوفّر واجهة برمجة تطبيقات بديلة. لا تتوفّر واجهة برمجة تطبيقات بديلة.

واجهة برمجة تطبيقات BLE

يمكن لتطبيقك العثور على أجهزة Bluetooth منخفضة الطاقة (BLE) المتاحة وإدراج data الاستشعار في منصة Google Fit باستخدام BLE API.

عليك نقل البيانات من واجهة برمجة تطبيقات BLE API إلى واجهات برمجة التطبيقات أو الأنظمة الأساسية التالية:

الهاتف Wear
استخدام واجهات برمجة تطبيقات Bluetooth في Android مباشرةً استخدام واجهات برمجة تطبيقات Bluetooth في Android مباشرةً