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

تم إيقاف واجهات Google Fit API نهائيًا، ومن المقرّر إيقاف الخدمة نهائيًا في أواخر عام 2026. توفّر Google العديد من المنتجات والخدمات المتعلقة بالصحة والعافية لمساعدة المستخدمين في مواصلة تحقيق أهدافهم بعد إيقاف الخدمة.

تنبيه: لن تكون واجهة Google Fit API (بما في ذلك REST API) متاحةً إلا حتى نهاية عام 2026. ننصحك بنقل البيانات إلى Google Health API لإجراء عمليات دمج مستندة إلى السحابة الإلكترونية أو إلى Health Connect لتتبُّع الخطوات والتطبيقات المتوافقة مع الأجهزة الجوّالة أولاً.

توضّح لك الإرشادات التالية الخدمة التي يجب نقل البيانات إليها استنادًا إلى طريقة استخدامك لواجهات Google Fit API.

مسارات نقل البيانات المقترَحة

يجب أن يستند اختيارك لواجهة برمجة التطبيقات إلى نوع تطبيقك واحتياجاتك المحدّدة من البيانات.

حسب نوع التطبيق

نوع التطبيق	المسار المقترَح	السبب الأساسي
تطبيق تتبُّع الخطوات	Health Connect	قراءة بيانات الخطوات المجمّعة من مصادر مختلفة بشكل أساسي على الأجهزة الجوّالة
تطبيق مصاحب لأدوات تتبُّع اللياقة البدنية	Google Health API	منصة تركز على الويب وتتطلب استخدام بروتوكول OAuth لدمج المستخدمين
منصة الصحة واللياقة البدنية	واجهة Google Health API وHealth Connect	استخدِم Google Health API لبيانات أجهزة Fitbit/Google وHealth Connect للبيانات المجمّعة على الجهاز فقط.

حسب عملية الدمج الحالية

عملية الدمج الحالية	المسار المقترَح	مدى التوفّر
‫Google Fit (نظام التشغيل Android وREST API)	Google Health API	متاح
قراءة خطوات الجهاز الجوّال (باستخدام Google Fit Recording API)	Health Connect	متاح
Fit API على Wear OS	خدمات الصحة	متاح
Fitbit Web API	Google Health API	متاح
Recording API على الأجهزة الجوّالة	Health Connect	متاح
Health Connect	الحفاظ على عملية الدمج الحالية أو إضافة Google Health API	متاح

المقارنات الفنية

تقدّم الأقسام التالية مقارنة فنية بين واجهات برمجة التطبيقات في Google Fit وGoogle Health API وHealth Connect لمساعدتك في اختيار مسار النقل المناسب.

الفرق بين Fit API وGoogle Health API

استخدِم هذا المسار إذا كان تطبيقك عبارة عن منصة مستندة إلى الويب أو يتطلّب تفاعلات من الخادم إلى الخادم (S2S).

الميزة	Fit API (Android/REST)	Google Health API
إعداد المشروع	Google Cloud Console	إنشاء مشروع على السحابة الإلكترونية من Google
إعدادات OAuth	نوع تطبيق Android أو الويب	نوع تطبيق الويب
هندسة البيانات	com.google الأنواع التي تبدأ ببادئة	أنواع البيانات الموحّدة في Google Health API
تسجيل التطبيق	إنشاء مشروع على السحابة الإلكترونية من Google	إنشاء مشروع على Google Cloud وتفعيل Google Health API

مقارنة بين Fit API وHealth Connect

استخدِم هذا المسار لتطبيقات Android التي تعمل على الأجهزة الجوّالة أولاً والتي تقرأ مقاييس الجهاز المحلي.

الميزة	Fit API لأجهزة Android	Health Connect
التسجيل	Google Cloud Console	مشروع "متجر Play" وبيان التطبيقات المتعلّقة بالصحة
المصادقة	مطلوب استخدام OAuth 2.0	لا يلزم استخدام OAuth (أذونات على الجهاز فقط)
تخزين البيانات	التركيز على السحابة الإلكترونية	التركيز على الجهاز (على الجهاز فقط)
الجمهور	مطوّرو تطبيقات Android القدامى	مطوّرو تطبيقات Android الحديثة على الأجهزة الجوّالة
الأذونات	نطاقات OAuth	أذونات ملف البيان في Android

عمليات دمج Fit API

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

التطبيقات التي تستخدم Fit Recording API لتسجيل الخطوات

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

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

الجدول 1: خطوات نقل البيانات من Fit Recording API

الهاتف	Wear
لعرض إجمالي عدد الخطوات، عليك إضافة Health Connect إلى تطبيقك. يشمل الإجمالي الخطوات التي تم احتسابها على الجهاز الجوّال (Android 14 أو الإصدارات الأحدث) والخطوات من التطبيقات والأجهزة الأخرى. لمواصلة عرض بيانات الخطوات المحلية في تطبيقك، عليك تنفيذ عملية كتابة البيانات باستخدام واجهة برمجة التطبيقات الخاصة بالكتابة في Health Connect.	استخدام "خدمات الصحة": PassiveMonitoringClient ExerciseClient يمكنك الاطّلاع على مستندات "خدمات الصحة" لمعرفة المزيد عن الاختلافات بينهما.

التطبيقات التي تستخدم History API لقراءة البيانات أو كتابتها في متجر اللياقة البدنية

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

اتّبِع الخطوات التالية لإجراء عملية نقل البيانات من History API:

الجدول 2: خطوات نقل البيانات من Fit History API

الهاتف	Wear
الانتقال إلى Google Health API	غير منطبق. استخدام Health Connect من تطبيقك على الجهاز الجوّال وليس من الجهاز القابل للارتداء

التطبيقات التي تستخدم Sensor API لعرض بيانات اللياقة البدنية في الوقت الفعلي

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

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

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

الجدول 3: خطوات نقل البيانات من Fit Sensor API

الهاتف	Wear
استخدام أدوات الاستشعار وواجهة برمجة التطبيقات Fused Location Provider API	استخدام خدمات الصحة على Wear OS: PassiveMonitoringClient MeasureClient ExerciseClient أو استخدِم SensorManager وFusedLocationProvider.

التطبيقات التي تستخدم Session API لتقديم ملخّصات الأنشطة

تمثّل الجلسات فاصلًا زمنيًا ينفّذ خلاله المستخدمون نشاطًا رياضيًا.

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

اتّبِع الخطوات التالية لإجراء عملية النقل من Session API:

الجدول 4: خطوات نقل البيانات من Fit Session API

الهاتف	Wear
البدء/الإيقاف: لا ينطبق. يجب أن يتتبّع التطبيق حالة الجلسات الجارية داخليًا. القراءة/الكتابة: الانتقال إلى Google Health API	البدء/الإيقاف: استخدام "خدمات الصحة" (ExerciseClient) القراءة/الكتابة: استخدام Health Connect مع تطبيقك على الأجهزة الجوّالة بالنسبة إلى سير العمل المحدّد، ننصح بما يلي: إدراج جلسة: على المطوّرين استخدام Health Connect مع تطبيقاتهم على الأجهزة الجوّالة وإدراج ExerciseSessionRecord أو SleepSessionRecord حسب الاقتضاء.

التطبيقات التي تستخدم Goals API

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

الجدول 5: إرشادات نقل البيانات لواجهة برمجة التطبيقات Fit Goals API

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

التطبيقات التي تستخدم واجهة برمجة تطبيقات Bluetooth Low Energy

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

اتّبِع الخطوات التالية للانتقال من واجهة برمجة تطبيقات Bluetooth Low Energy:

الجدول 6: خطوات نقل البيانات من Fit BLE API

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

الميزات التي تم إيقافها نهائيًا

لا تتوفّر بدائل مباشرة لواجهات برمجة التطبيقات للميزات التالية. استخدام واجهات برمجة التطبيقات العادية المقترَحة في Android:

• Sensor API: استخدِم إطار عمل Android Sensors أو Fused Location Provider API للحصول على بيانات أولية في الوقت الفعلي.
• Goals API: لا تتوفّر واجهة برمجة تطبيقات بديلة. إدارة تتبُّع الأهداف ومستويات النشاط اليومي المستهدَفة ضمن منطق تطبيقك
• واجهة برمجة تطبيقات البلوتوث المنخفض الطاقة (BLE): يمكنك استخدام واجهات برمجة تطبيقات البلوتوث في Android مباشرةً للتواصل مع الأجهزة.

عمليات الدمج في تطبيق Fit

إذا كان تطبيقك يتصل بتطبيق Google Fit لمشاركة البيانات، اتّبِع الإرشادات الواردة في الأقسام التالية بشأن نقل بيانات المستخدمين الحاليين والجدد إلى Health Connect أو Google Health API:

المستخدمون الحاليون لتطبيقك

إذا كانت واجهة مستخدم تطبيقك تتضمّن طريقة تتيح للمستخدمين الربط بتطبيق Google Fit (أو إذا كان تطبيقك مُدرَجًا في قائمة التطبيقات المتوافقة مع Google Fit)، يمكنك مواصلة إتاحة إمكانية دمج تطبيقك مع Fit للمستخدمين الحاليين.

سنحرص على تعديل هذا القسم باستمرار لإطلاعك على المعلومات المتعلقة بموعد إيقاف عملية دمج تطبيقك مع Fit، وأفضل الخيارات المتاحة لك للحفاظ على تجربة المستخدم. في الوقت الحالي، يمكنك التواصل معنا.

الجدول 7: اقتراحات للمستخدمين الحاليين الذين لديهم عمليات دمج مع تطبيق Fit

التحقّقإرشادات	closeلا تفعل ذلك
توفير Health Connect أو Google Health API كخيار جديد في تطبيقك التركيز على مزايا المستخدمين، مثل البيانات والإحصاءات الأكثر تفصيلاً والخصوصية والأمان	اطلب من المستخدمين إلغاء الربط بتطبيق Google Fit.

المستخدمون الجدد لتطبيقك

لتقديم تجربة مشابهة للمستخدمين الجدد لتطبيقك، ننصحك بإنشاء عملية دمج مع Health Connect أو Google Health API.

يتيح تطبيق Health Connect الوصول إلى مصادر وأنواع جديدة من البيانات لتوفير تجربة أفضل للمستخدمين، مع تخزين البيانات بأمان على الجهاز فقط. توفّر Google Health API منصة تركّز على الويب لبيانات أجهزة Fitbit وGoogle.

الجدول 8: اقتراحات للمستخدمين الجدد الذين يستخدمون عمليات الدمج مع تطبيق Fit

التحقّقإرشادات	closeلا تفعل ذلك
ضمِّن Health Connect أو Google Health API في عملية الإعداد في تطبيقك.	توفير Fit كتطبيق يمكن للمستخدمين ربطه بعد إتاحة Health Connect