إنّ واجهات برمجة تطبيقات 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 API، يجب أن يكون لديك حساب Google. يمكنك إنشاء حساب جديد أو
استخدام حساب حالي. يمكنك إنشاء حساب منفصل لاختبار
تطبيقك من منظور المستخدم.
الحصول على خدمات Google Play
احصل على أحدث مكتبة عملاء لـ "خدمات Google Play" على مضيف تطوير التطبيقات:
ننصحك باستخدام بيئة تطوير "استوديو Android" لإنشاء تطبيق باستخدام Fitness API. للحصول على
تفاصيل عن كيفية إنشاء مشروع جديد وضبطه في "استوديو Android"، اطّلِع على مقالة
إنشاء مشروع.
إضافة مكتبة برامج "خدمات Google Play"
في Android Studio، افتح ملف build.gradle الخاص بوحدتك وأضِف مكتبة عملاء "خدمات Google Play" كعنصر تابع:
تتوافق أنواع البيانات التي يملك تطبيقك إذن الوصول إليها مع
نطاقات التفويض. لطلب
هذه الأذونات، عليك إضافة
أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها في FitnessOptions
مثيل. عندما يطلب تطبيقك استخدام أيّ من
أنواع بيانات Google Fit، تتحقّق حزمة تطوير البرامج (SDK) لنظام التشغيل Android تلقائيًا من النطاقات التي تنتمي إليها تلك البيانات، وتطلب
من المستخدم تفويضًا لهذه النطاقات.
إنشاء عميل لواجهة برمجة التطبيقات
أنشئ عميل واجهة برمجة تطبيقات وأضِف أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها لقراءة البيانات أو كتابتها. تتوفّر نقاط النهاية التالية:
SensorsClient: يمكنك الوصول إلى مصادر مختلفة لبيانات الصحة والعافية من أجهزة الاستشعار في الجهاز المحلي والأجهزة المصاحبة.
RecordingClient: لجمع بيانات أجهزة الاستشعار في الخلفية بشكل دائم واستهلاك طاقة منخفض
HistoryClient: إدراج البيانات السابقة وحذفها وقراءتها في
Google Fit
في ما يلي خطوات التفويض الناتجة التي يواجهها المستخدمون عند طلب الأذونات:
الشكل 1: عملية التفويض للمستخدمين
أذونات Android: تظهر للمستخدمين أذونات Android التي طلبها تطبيقك
قبل تنزيله. بعد تنزيل تطبيقك،
يطلب أي أذونات تشغيل يحتاجها، ويمنح المستخدمون
هذه الأذونات أو يرفضونها.
التحقّق والربط: يتحقّق تطبيقك مما إذا تم منح الأذونات
قبل أن يطلب الوصول إلى أنواع البيانات الأخرى.
طلب نطاقات OAuth: تطلب Google من المستخدم منح تطبيقك
نطاقات OAuth اللازمة لأنواع البيانات التي يريد الوصول إليها.
الوصول المُطبَّق: بعد أن يمنح المستخدم الأذونات، يمكن لتطبيقك
الوصول إلى أنواع البيانات التي تنتمي إلى النطاقات التي منح المستخدم
الإذن بها.
تاريخ التعديل الأخير: 2025-03-11 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This guide provides instructions for Android developers to integrate Google Fit into their applications."],["It outlines the necessary setup steps, including obtaining a Google account, setting up Google Play services, and acquiring OAuth 2.0 client ID."],["Developers are guided through the process of creating an API client and implementing data access functionalities."],["Before publishing, developers need to apply for verification to ensure data security and compliance."],["The guide also explains the authorization flow users will experience when granting data access permissions to the app."]]],[]]