إنّ واجهات برمجة تطبيقات Google Fit، بما في ذلك Google Fit REST API، لن تعود متاحة بعد 30 حزيران (يونيو) 2025. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة المطلوب نقل البيانات إليها، انتقِل إلى دليل نقل البيانات إلى Health Connect. للمقارنة بين Health Connect وواجهات برمجة تطبيقات Google Fit وواجهات برمجة تطبيقات الويب Fitbit، يُرجى الانتقال إلى دليل المقارنة في Health Connect.
يوضّح هذا الدليل كيفية بدء تطوير التطبيق باستخدام Google Fit على نظام Android.
ضبط إعدادات الجهاز
قبل البدء في إنشاء تطبيقك، أكمل الخطوات الواردة في الأقسام التالية.
الحصول على حساب Google
لاستخدام واجهات برمجة تطبيقات Google Fit، يجب أن يكون لديك حساب على Google. ويمكنك إنشاء حساب جديد
أو استخدام حساب حالي. قد تحتاج إلى إنشاء حساب منفصل لاختبار تطبيقك من منظور المستخدم.
الحصول على خدمات Google Play
احصل على أحدث مكتبة عملاء لخدمات Google Play على مضيف التطوير:
نقترح استخدام بيئة تطوير Android Studio لإنشاء تطبيق باستخدام Fitness API. للحصول على
تفاصيل حول كيفية إنشاء مشروع جديد وإعداده في "استوديو Android"، يمكنك الاطّلاع على
إنشاء مشروع.
إضافة مكتبة عملاء "خدمات Google Play"
في "استوديو Android"، افتح ملف build.gradle للوحدة التنظيمية وأضِف مكتبة برامج "خدمات Google Play" كملحق:
يضمن ذلك تنزيل Gradle تلقائيًا لحزمة SDK للّياقة البدنية عندما تنشئ تطبيقك.
إنشاء تطبيقك واختباره
بعد الانتهاء من خطوات الإعداد، يمكنك البدء في إنشاء تطبيقك. وللبدء، تعرَّف على أنواع البيانات التي يمكن لتطبيقك تخزينها وقراءتها. تعرّف على المزيد من المعلومات حول استخدام
البيانات في Google Fit.
تتوافق أنواع البيانات التي يمتلك تطبيقك إذنًا بالوصول إليها مع
نطاقات التفويض. لطلب هذه الأذونات، عليك إضافة
أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها في مثيل FitnessOptions. عندما يطلب تطبيقك استخدام أيٍّ من أنواع بيانات Google Fit، تتحقق حزمة تطوير البرامج (SDK) لنظام التشغيل Android تلقائيًا من النطاقات التي تنتمي إليها وتطلب من المستخدم منح الإذن لهذه النطاقات.
إنشاء عميل واجهة برمجة تطبيقات
أنشئ عميل واجهة برمجة تطبيقات وأضف أنواع البيانات التي يحتاج تطبيقك الوصول إليها لكتابة البيانات أو قراءتها. تتوفّر نقاط النهاية التالية:
SensorsClient: يمكنك الوصول إلى مصادر مختلفة لبيانات الصحة والعافية من أجهزة الاستشعار في الأجهزة على الجهاز المحلي وفي الأجهزة المصاحبة.
RecordingClient: لجمع بيانات أداة الاستشعار في الخلفية بتكلفة منخفضة وتكون قيد التشغيل دائمًا.
HistoryClient: يمكنك إدراج البيانات السابقة وحذفها وقراءتها في
Google Fit.
يوضح ما يلي تدفق التفويض الناتج الذي يواجهه المستخدمون عند مطالبتهم بالأذونات:
أذونات Android: يمكن للمستخدمين الاطّلاع على أذونات Android التي طلبها تطبيقك قبل تنزيله. بعد تنزيل تطبيقك،
يطلب الحصول على أي أذونات وقت تشغيل مطلوبة، ويمنح المستخدمون هذه
الأذونات أو يرفضونها.
التحقّق والربط: يتحقّق تطبيقك ممّا إذا تم منح الأذونات
قبل أن يطلب الوصول إلى أنواع بيانات أخرى.
طلب نطاقات OAuth: تطلب Google من المستخدم منح تطبيقك
نطاقات OAuth اللازمة لأنواع البيانات التي يريد الوصول إليها.
تم تطبيق إذن الوصول: بعد أن يمنح المستخدم الأذونات، يمكن
لتطبيقك الوصول إلى أنواع البيانات التي تنتمي إلى النطاقات التي منحها المستخدم
الإذن.