سيتم إيقاف واجهات Google Fit API نهائيًا في عام 2026، بما في ذلك Google Fit REST API. اعتبارًا من 1 مايو 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.

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

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

البدء على Android

يوضّح هذا الدليل كيفية بدء عملية التطوير باستخدام Google Fit على Android.

الإعداد

قبل البدء في إنشاء تطبيقك، أكمِل الخطوات الواردة في الأقسام التالية.

أنشئ حسابًا على Google

لاستخدام واجهات برمجة التطبيقات Google Fit، يجب أن يكون لديك حساب Google. يمكنك إنشاء حساب جديد أو استخدام حساب حالي. ننصحك بإنشاء حساب منفصل لاختبار تطبيقك من منظور المستخدم.

الحصول على خدمات Google Play

احصل على أحدث مكتبة برامج لخدمات Google Play على جهاز التطوير باتّباع الخطوات التالية:

افتح SDK Manager.
ضِمن أدوات حزمة تطوير البرامج (SDK)، ابحث عن خدمات Google Play.
إذا لم تكن حالة هذه الحِزم مثبَّتة، اختَر كلتيهما وانقر على تثبيت الحِزم.

الحصول على معرّف عميل OAuth 2.0

لتفعيل Fitness API، عليك الحصول على معرّف عميل OAuth 2.0.

إنشاء مشروعك وإعداده

ننصحك باستخدام بيئة تطوير "استوديو Android" لإنشاء تطبيق باستخدام Fitness API. للحصول على تفاصيل حول كيفية إنشاء مشروع جديد وإعداده في "استوديو Android"، يمكنك الاطّلاع على إنشاء مشروع.

إضافة مكتبة برامج "خدمات Google Play"

في Android Studio، افتح ملف build.gradle للوحدة وأضِف مكتبة برامج العميل لخدمات Google Play كعنصر تابع:

Kotlin DSL

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.3.0'
    implementation 'com.google.android.gms:play-services-auth:22.0.0'
}

يضمن ذلك أن تنزّل Gradle حزمة تطوير البرامج (SDK) الخاصة باللياقة البدنية تلقائيًا عند إنشاء تطبيقك.

إنشاء تطبيقك واختباره

بعد الانتهاء من خطوات الإعداد، يمكنك البدء في إنشاء تطبيقك. وللبدء، تعرَّف على أنواع البيانات التي يمكن لتطبيقك تخزينها وقراءتها. مزيد من المعلومات حول التعامل مع البيانات في Google Fit

الحصول على أذونات Android اللازمة

لقراءة بعض أنواع البيانات وكتابتها، يجب أن يطلب تطبيقك أذونات Android.

الحصول على أذونات OAuth

تتطابق أنواع البيانات التي يملك تطبيقك إذن الوصول إليها مع نطاقات التفويض. لطلب هذه الأذونات، عليك إضافة أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها في FitnessOptionsمثيل. عندما يطلب تطبيقك استخدام أي من أنواع بيانات Google Fit، تتحقّق حزمة تطوير البرامج (SDK) لنظام التشغيل Android تلقائيًا من النطاقات التي تنتمي إليها وتطلب من المستخدم منح إذن الوصول إلى هذه النطاقات.

إنشاء برنامج عميل لواجهة برمجة التطبيقات

أنشئ برنامجًا لعميل واجهة برمجة التطبيقات وأضِف أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها لكتابة البيانات أو قراءتها. تتوفّر نقاط النهاية التالية:

SensorsClient: الوصول إلى مصادر مختلفة لبيانات الصحة والعافية من أجهزة الاستشعار في الجهاز المحلي والأجهزة المصاحبة
RecordingClient: لجمع بيانات أجهزة الاستشعار في الخلفية بشكل دائم وبطاقة منخفضة
HistoryClient: إدراج البيانات السابقة وحذفها وقراءتها في Google Fit
SessionsClient: إنشاء الجلسات الخاصة بنشاط المستخدم وإدارتها
GoalsClient: لقراءة أهداف "نقاط القلب" و"الخطوات" التي أنشأها المستخدمون في Google Fit
‫ConfigClient: الوصول إلى أنواع البيانات والإعدادات المخصّصة في منصة Google Fit

مثال على كيفية إنشاء برنامج Fitness API.

مسار تفويض المستخدم الناتج

يوضّح ما يلي مسار منح الإذن الناتج الذي يواجهه المستخدمون عندما يُطلب منهم منح الأذونات:

أذونات Android: يرى المستخدمون أذونات Android التي طلبها تطبيقك قبل تنزيله. بعد تنزيل تطبيقك، سيطلب أي أذونات تشغيل يحتاجها، وسيوافق المستخدمون على هذه الأذونات أو يرفضونها.
التحقّق والربط: يتحقّق تطبيقك مما إذا تم منح الأذونات قبل أن يطلب الوصول إلى أنواع البيانات الأخرى.
طلب نطاقات OAuth: يطلب محرك بحث Google من المستخدم منح تطبيقك نطاقات OAuth اللازمة لأنواع البيانات التي يريد الوصول إليها.
تم منح إذن الوصول: بعد أن يمنح المستخدم الأذونات، يمكن لتطبيقك الوصول إلى أنواع البيانات التي تنتمي إلى النطاقات التي منح المستخدم الإذن بالوصول إليها.

تقديم طلب لإثبات الهوية

بعد إنشاء تطبيقك واختباره، عليك تقديم طلب لإجراء عملية التحقّق مع توفير مستويات مختلفة من المستندات الثبوتية المطلوبة للنطاقات الحسّاسة والمقيّدة.