سيتم إيقاف واجهات برمجة تطبيقات Google Fit نهائيًا في عام 2026، بما في ذلك واجهة برمجة التطبيقات Google Fit REST API. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة التي تريد نقل البيانات إليها، يُرجى الانتقال إلى دليل نقل البيانات في Health Connect. للاطّلاع على مقارنة بين Health Connect وGoogle Fit API وFitbit Web API، يُرجى الانتقال إلى دليل مقارنة Health Connect.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُعدّ واجهات برمجة التطبيقات Google Fit API لنظام التشغيل Android جزءًا من خدمات Google Play. يتم دعم واجهات برمجة تطبيقات Google Fit على
Android 4.1 (المستوى 16 من واجهة برمجة التطبيقات) والإصدارات الأحدث. باستخدام واجهات برمجة التطبيقات هذه، يمكن لتطبيقك تنفيذ ما يلي:
يمكنك قراءة البيانات السابقة والبيانات في الوقت الفعلي تقريبًا، بما في ذلك البيانات الواردة من أجهزة البلوتوث المنخفض الطاقة (BLE).
تسجيل الأنشطة
ربط البيانات بالجلسة.
تحديد أهداف اللياقة البدنية
قراءة بيانات أداة الاستشعار
إذا كان تطبيقك يوفّر معلومات حول نشاط المستخدم، مثل خطواته اليومية، قد يكون من المفيد عرض بيانات في الوقت الفعلي تقريبًا حول حركات المستخدم.
توفر Sensors API إمكانية الوصول إلى مصادر البيانات الأولية التي تحتوي على هذه المعلومات. يمكن أن تأتي هذه البيانات من أدوات الاستشعار المتوفرة على الجهاز الذي يعمل بنظام التشغيل Android وكذلك من أجهزة الاستشعار في الأجهزة المصاحبة، مثل الأجهزة القابلة للارتداء.
تسجيل البيانات
إذا كان تطبيقك يحتاج إلى جمع بيانات عن النشاط البدني للمستخدم وتخزينها ومزامنتها، يمكنك استخدام التسجيلات من واجهة برمجة التطبيقات. تخزِّن واجهة برمجة التطبيقات هذه
بيانات الصحة والعافية باستخدام الاشتراكات. يحدد تطبيقك نوعًا واحدًا أو أكثر
من الأنشطة لتسجيلها. بعد ذلك، يخزِّن Google Fit بيانات من
الأنواع المحددة في الخلفية حتى عندما لا يكون تطبيقك قيد التشغيل. ويستعيد أيضًا
هذه الاشتراكات عند إعادة تشغيل النظام.
الشكل 1. تطبيق Google Fit على Android
البيانات السابقة
إذا أردت أن يتمكّن المستخدمون من عرض بيانات اللياقة البدنية من الأنشطة السابقة، يمكنك
استخدام History API. توفّر واجهة برمجة التطبيقات هذه إمكانية الوصول إلى بيانات الصحة والعافية السابقة، كما تسمح للتطبيقات بإجراء عمليات مجمّعة، مثل إدراج البيانات وحذفها وقراءتها.
الجلسات
يمكن أن تكون بيانات اللياقة البدنية مفيدة في حد ذاتها، إلا أن البيانات تكون أكثر فائدة عند
دمجها مع معلومات إضافية حول نشاط المستخدم. تعمل Sessions API على تجميع بيانات الصحة والعافية، بالإضافة إلى بعض
البيانات الوصفية، في وحدات باسم sessions. تمثل الجلسات فاصلاً زمنيًا يقوم المستخدم خلاله
بنشاط لياقة بدنية.
عرض الأهداف وتحديدها
يمكن لتطبيقك المساعدة في تحفيز المستخدمين من خلال توضيح مستوى نشاط اللياقة البدنية لديهم مقارنةً بالأهداف التي وضعوها. تساعد واجهة برمجة تطبيقات الأهداف تطبيقك على
عرض أهداف الصحة واللياقة البدنية التي أنشأها للمستخدمين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe Google Fit APIs let your Android app read, record, and store fitness and wellness data from various sources, including BLE devices.\u003c/p\u003e\n"],["\u003cp\u003eApps can use the Recording API to continuously track user activity in the background, even when the app isn't actively running.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access and manage historical fitness data, enabling users to view past activities and trends through the History API.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Fit allows data to be grouped into sessions, providing context and insights into specific user activities with the Sessions API.\u003c/p\u003e\n"],["\u003cp\u003eApps can leverage the Goals API to display and manage user fitness goals, promoting engagement and motivation.\u003c/p\u003e\n"]]],[],null,["# Android APIs\n\nThe Google Fit APIs for Android are part of [Google Play\nservices](/android/guides/overview). The Google Fit APIs are supported on\nAndroid 4.1 (API level 16) and higher. Using these APIs, your app can do the\nfollowing:\n\n- Read near-real-time and historic data, including data from Bluetooth Low Energy (BLE) devices.\n- Record activities.\n- Associate data with a session.\n- Set fitness goals.\n\nRead sensor data\n----------------\n\nIf your app provides information about a user's activity, such as their daily\nsteps, it can be helpful to show near-real-time data about the user's movements.\nThe [Sensors API](/fit/android/sensors) provides access to streams of raw data\nthat contain this information. The data can come from sensors available on the\nAndroid-powered device as well as from sensors in companion devices, such as\nwearables.\n\nRecord data\n-----------\n\nIf your app needs to gather, store, and sync data about a user's physical\nactivity, you can use the [Recording API](/fit/android/record). This API stores\nhealth and wellness data using subscriptions. Your app specifies one or more\ntypes of activities to record. Google Fit then stores data of the\nspecified types in the background even when your app isn't running. It also\nrestores these subscriptions when the system is restarted. \n**Figure 1.** Google Fit on Android.\n\nHistorical data\n---------------\n\nIf you want users to be able to view fitness data from past activities, you can\nuse the [History API](/fit/android/history). This API provides access to the\nhistorical health and wellness data and lets apps perform bulk operations, such\nas inserting, deleting, and reading data.\n\nSessions\n--------\n\nFitness data can be beneficial by itself, but the data is more useful when you\ncombine it with additional information about the user's activity. The [Sessions\nAPI](/fit/android/using-sessions) bundles health and wellness data, along with\nsome metadata, into units called *sessions*. Sessions represent a time interval\nduring which the user performs a fitness activity.\n\nView and set goals\n------------------\n\nYour app can help motivate users by showing how their fitness activity compares\nto the goals that they've set. The [Goals API](/fit/android/goals) helps your\napp show users the health and fitness goals that they've created."]]
