سيتم إيقاف واجهات برمجة تطبيقات Google Fit نهائيًا في عام 2026، بما في ذلك واجهة برمجة التطبيقات Google Fit REST API. اعتبارًا من 1 أيار (مايو) 2024، لن يتمكّن المطوّرون من الاشتراك لاستخدام واجهات برمجة التطبيقات هذه.
للحصول على تعليمات حول واجهة برمجة التطبيقات أو المنصة التي تريد نقل البيانات إليها، يُرجى الانتقال إلى دليل نقل البيانات في Health Connect. للاطّلاع على مقارنة بين Health Connect وGoogle Fit API وFitbit Web API، يُرجى الانتقال إلى دليل مقارنة Health Connect.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتضمّن هذه الصفحة معلومات عن إصدارات Google Fit API.
يسرد سجل التغيير الإصدارات حسب التاريخ ويتضمن أي ميزات
جديدة، أو إصلاحات أخطاء أو تحسينات كبيرة في الأداء.
2 آب (أغسطس) 2021
أصبحت الكتابة في أنواع البيانات الصحية متاحة الآن
للمطوّرين بشكل عام. يتوافق إذن الوصول إلى أنواع البيانات
الصحية مع جميع أنواع البيانات الأخرى. يمكنك الاطّلاع على المزيد من التفاصيل هنا.
27 نيسان (أبريل) 2021
حدث تأخير بسيط في تنفيذ التغييرات في التراخيص
التي تم الإعلان عنها في 10 تشرين الأول (أكتوبر) 2020. وسيبدأ تنفيذ تغييرات التفويض
اعتبارًا من 4 مايو 2021.
في إطار جهودنا المستمرة لتعزيز أمان وخصوصية Google Fit بالنسبة إلى المطورين والمستخدمين، أجرينا بعض التغييرات على سياسات Google Fit وواجهات برمجة التطبيقات:
سيسمح الوصول إلى الكتابة الآن للتطبيق بقراءة البيانات التي كتبها فقط. لمواصلة قراءة البيانات التي كتبتها تطبيقات أخرى من نظام Google Fit الأساسي، عليك تعديل الترميز لطلب نطاقات الوصول للقراءة الخاصة بأنواع البيانات ذات الصلة.
بيانات معدل ضربات القلب لها نطاقاتها الخاصة.
بيانات النوم لها نطاقاتها الخاصة ونوع بيانات جديد.
عند استخدام SessionsClient، عليك الآن تحديد نوع الجلسة التي يحتاج تطبيقك إلى الوصول إليها، وذلك باستخدام الطرق المناسبة من FitnessOptions.
ستصبح هذه التغييرات على واجهة برمجة التطبيقات متاحة للمطوّرين لاستخدامها اعتبارًا من 19 تشرين الأول (أكتوبر) 2020. وسيبدأ تنفيذ السياسة اعتبارًا من 27 نيسان (أبريل) 2021.
يمكنك الاطّلاع هنا على مزيد من التفاصيل والتعليمات حول هذه التغييرات.
21 آذار (مارس) 2019
يعرض تطبيق Google Fit الآن جلسات النوم المكتوبة في واجهة برمجة تطبيقات Android.
تعرَّف على مزيد من المعلومات حول كتابة وقراءة بيانات النوم.
19 تشرين الثاني (نوفمبر) 2018
تم إجراء التغييرات التالية على Google Fit API:
عند قراءة طلبات أنواع البيانات com.google.location.sample وcom.google.location.bounding_box، ستعرض فقط بيانات للتطبيق نفسه الذي كتب البيانات.
26 أيلول (سبتمبر)، 2018
يوفر الإصدار 16.0.0 من "خدمات Google Play" إمكانية الوصول إلى نوعين جديدين من البيانات
والبيانات المجمّعة لكل منهما:
تم تحديث Fitness API للعملاء الجدد المستنِدين إلى GoogleApi، والتي تدير تلقائيًا عمليات الربط بالخدمات وتتطلّب استخدام رموز نموذجية أقل:
تمت إضافة الفئة BleClient وطُرق Fitness.getBleClient(). يوفّر BleClient نقطة الدخول لفحص الأجهزة التي تتضمّن بلوتوث منخفض الطاقة والمطالبة بها واستخدامها في Google Fit.
تمت إضافة الفئة ConfigClient وطُرق Fitness.getConfigClient(). توفّر "ConfigClient" نقطة الدخول للوصول إلى أنواع البيانات المخصّصة والإعدادات في Google Fit.
تمت إضافة الفئة GoalsClient وطُرق Fitness.getGoalsClient(). توفّر "GoalsClient" نقطة الدخول إلى أجهزة Goal اللياقة البدنية التي أنشأها المستخدمون في Google Fit.
تمت إضافة الفئة RecordingClient وطُرق Fitness.getRecordingClient(). يوفّر RecordingClient نقطة الدخول للسماح بجمع بيانات أداة الاستشعار في الخلفية بتكلفة منخفضة ويتم تشغيلها دائمًا في Google Fit.
تمت إضافة الفئة SensorsClient وطُرق Fitness.getSensorsClient(). توفّر "SensorsClient" نقطة الدخول لعرض مصادر مختلفة لبيانات اللياقة البدنية على الأجهزة المحلية والمتصلة، وتقديم أحداث مباشرة للمستمعين.
تبدأ منصة Fit في تتبُّع بيانات المسافة والسعرات الحرارية بمجرد اشتراك أحد التطبيقات على الجهاز في هذه البيانات. لمزيد من المعلومات حول طريقة الاشتراك في أنواع البيانات، يمكنك مراجعة تسجيل بيانات اللياقة البدنية.
لذا، فإنّ البيانات غير متوفرة في الوقت الفعلي باستخدام
Sensors API.
أصبح بإمكان منصة Fit الآن تخزين بيانات التمارين الرياضية، مثل تمرين عضلات العضلة العضلية
وتمرين القرفصاء، باستخدام نوع البيانات com.google.activity.exercise. لمزيد من المعلومات حول التمارين التي يمكن لتطبيق Fit تخزينها، يمكنك الاطّلاع على WorkoutExercises.
أصبح بإمكان منصة Fit الآن تتبُّع بيانات التغذية باستخدام نوع البيانات com.google.fitness.
تم إيقاف نوع بيانات "com.google.calories.consumed" نهائيًا الآن. يمكن تسجيل معدّل استهلاك
السعرات الحرارية باستخدام نوع البيانات com.google.fitness.item.
يمكن للمطوّرين استرداد عدد الخطوات الإجمالي اليومي للاستخدام في مجالات مثل خلفيات شاشة ساعة Android Wear. لمزيد من المعلومات، يُرجى الاطّلاع على
قراءة إجمالي البيانات اليومية.
تم تقسيم واجهة برمجة تطبيقات Google Fit إلى وحدات كي تتمكن من اختيار الميزات التي تريد تضمينها في تطبيقك. ويقلل هذا التغيير إلى حد كبير من متطلبات الذاكرة للتطبيقات التي تفعِّل Google Fit ويؤثر في طريقة وصولك إلى واجهات برمجة التطبيقات. للحصول على مزيد من المعلومات حول طريقة تعديل الرمز، يمكنك الاطّلاع على
الاتصال بخدمة اللياقة البدنية.
والآن، تحتسب منصة Fit المسافة. للوصول إلى البيانات، يمكنك استخدام
نوع البيانات "com.google.distance.delta". لمزيد من المعلومات حول أنواع البيانات، يمكنك الاطّلاع على مقالة
أنواع بيانات اللياقة البدنية.
يمكن للمطوّرين الآن قراءة بيانات النوم الدقيقة وكتابتها.
ويشمل هذا النوم الخفيف والنوم العميق وحركة العين السريعة وأنشطة اليقظة. تمت إضافة أنواع الأنشطة الدقيقة هذه إلى النوع FitnessActivities العددي.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page lists Google Fit API releases, including new features, bug fixes, and performance improvements.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Fit API has undergone authorization changes, including new data types and scopes for heart rate and sleep data.\u003c/p\u003e\n"],["\u003cp\u003eStarting May 4, 2021, Google Fit authorization changes went into effect, along with the Google Fit Developer and User Data Policy, and app verification began.\u003c/p\u003e\n"],["\u003cp\u003eWriting to Health data types became generally available on August 2, 2021, with authorization consistent with other data types.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Fit API introduced GoogleApi-based clients in November 2017, automatically managing service connections and offering new features like BLE device support and custom data type access.\u003c/p\u003e\n"]]],[],null,["This page contains information about Google Fit API releases.\nThe changelog lists releases by date and includes any new\nfeatures, bug fixes or significant performance improvements.\n\nAugust 2, 2021\n\nWriting to [Health data types](/fit/datatypes/health) is now generally available\nto developers. Authorization to access Health data types is consistent with all\nother data types. More details [here](/fit/datatypes#authorization_scopes).\n\nApril 27, 2021\n\nThere has been a small delay to enforcement of the [authorization changes](/fit/improvements#what_are_the_authorization_changes)\nannounced on October 10, 2020. The authorization changes will now be enforced\nfrom May 4, 2021.\n\nThe [Google Fit Developer and User Data Policy](/fit/policy) will also become\nenforceable on May 4, 2021. [App verification](/fit/improvements#strengthening_the_review_system_for_apps_using_google_fit)\n, as part of enforcement of the Fit developer policy, will start start in due\ncourse.\n\nOctober 19, 2020\n\nAs part of our ongoing efforts to enhance the security and privacy of Google Fit\nfor developers and users, we've made some changes to the Google Fit policies and\nAPIs:\n\n- There is a new [Google Fit Developer and User Data Policy](/fit/policy). Please review the policy, and if relevant, make appropriate changes to your apps and services.\n- Write-access will now only let an app read data it has written. To continue reading data written by *other apps* from the Google Fit platform, update your code to request read-access scopes for the relevant data types.\n- Heart rate data has its own scopes.\n- Sleep data has its own scopes and a new data type.\n- When working with the `SessionsClient`, you now need to specify what type of session your app needs to access, using the appropriate methods from `FitnessOptions`.\n\nThese changes to the API will be available for developers to use from 19 October\n2020. Enforcement will start from 27 April 2021.\n\nSee [here](/fit/improvements) for more details and instructions on these\nchanges.\n\nMarch 21, 2019\n\nThe Google Fit app now displays sleep sessions written to the Android API.\nLearn more about [writing](/fit/scenarios/write-sleep-data) and [reading](/fit/scenarios/read-sleep-data) sleep data.\n\nNovember 19, 2018\n\nThe following changes have been made to the Google Fit API:\n\n- Read requests for datatypes `com.google.location.sample` and `com.google.location.bounding_box` will only return data for the same app that has written the data.\n\nSeptember 26, 2018\n\nGoogle Play services fitness 16.0.0 provides access to two new data types and\ntheir respective aggregates:\n\n- [`TYPE_HEART_POINTS`](/android/reference/com/google/android/gms/fitness/data/DataType#TYPE_HEART_POINTS)\n- [`AGGREGATE_HEART_POINTS`](/android/reference/com/google/android/gms/fitness/data/DataType#AGGREGATE_HEART_POINTS)\n- [`TYPE_MOVE_MINUTES`](/android/reference/com/google/android/gms/fitness/data/DataType#TYPE_MOVE_MINUTES)\n- [`AGGREGATE_MOVE_MINUTES`](/android/reference/com/google/android/gms/fitness/data/DataType#AGGREGATE_MOVE_MINUTES)\n\nArtifacts released on maven.google.com\n\n- com.google.android.gms:play-services-fitness:16.0.0\n\nNovember 2017\n\n[Google Play services 11.6.0](//developer.android.com/google/play-services/index.html)\nintroduces the following new Google Fit features:\n\n- Updated the Fitness API for the new [`GoogleApi`](/android/reference/com/google/android/gms/common/api/GoogleApi)-based clients, which automatically manage connections to services and require less boilerplate code to use:\n - Added the [`BleClient`](/android/reference/com/google/android/gms/fitness/BleClient) class and the [`Fitness.getBleClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getBleClient(android.app.Activity,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `BleClient` provides the entry point for scanning, claiming, and using Bluetooth Low Energy devices in Google Fit.\n - Added the [`ConfigClient`](/android/reference/com/google/android/gms/fitness/ConfigClient) class and the [`Fitness.getConfigClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getConfigClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `ConfigClient` provides the entry point for accessing custom data types and settings in Google Fit.\n - Added the [`GoalsClient`](/android/reference/com/google/android/gms/fitness/GoalsClient) class and the [`Fitness.getGoalsClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getGoalsClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `GoalsClient` provides the entry point for reading fitness [`Goal`](/android/reference/com/google/android/gms/fitness/data/Goal)s created by users in Google Fit.\n - Added the [`HistoryClient`](/android/reference/com/google/android/gms/fitness/HistoryClient) class and the [`Fitness.getHistoryClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getHistoryClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `HistoryClient` provides the entry point for inserting, deleting, and reading data in Google Fit.\n - Added the [`RecordingClient`](/android/reference/com/google/android/gms/fitness/RecordingClient) class and the [`Fitness.getRecordingClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getRecordingClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `RecordingClient` provides the entry point for enabling low-power, always-on background collection of sensor data in Google Fit.\n - Added the [`SensorsClient`](/android/reference/com/google/android/gms/fitness/SensorsClient) class and the [`Fitness.getSensorsClient()`](/android/reference/com/google/android/gms/fitness/Fitness#getSensorsClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `SensorsClient` provides the entry point for exposing different sources of fitness data in local and connected devices, and delivering live events to listeners.\n - Added the [`SessionsClient`](/android/reference/com/google/android/gms/fitness/SessionsClient) class and the [`getSessionsClient`](/android/reference/com/google/android/gms/fitness/Fitness#getSessionsClient(android.content.Context,%20com.google.android.gms.auth.api.signin.GoogleSignInAccount)) methods. `SessionsClient` provides the entry point for creating and managing [`Session`](/android/reference/com/google/android/gms/fitness/data/Session)s of user activity in Google Fit.\n\nMay 2015\n\n[Google Play services 7.5](//developer.android.com/google/play-services/index.html)\nintroduces the following new Google Fit features:\n\n- Distance traveled and calories expended computations are available for subscription.\n - The Fit platform starts tracking distance and calorie data as soon as an app on the device subscribes to the data. For more information on how to subscribe to data types, see [Record Fitness Data](/fit/android/record).\n - The data is not available in real-time with the [Sensors API](/fit/android/sensors).\n- The Fit platform can now store exercise routine data, such as bicep curls and squats, with the `com.google.activity.exercise` data type. For more information on the exercises Fit can store, see [`WorkoutExercises`](/android-gcore/reference/com/google/android/gms/fitness/data/WorkoutExercises).\n\nApril 2015\n\n[Google Play services 7.3](//developer.android.com/google/play-services/index.html)\nintroduces the following new Google Fit features:\n\n- The Fit platform can now track nutrition data with the `com.google.fitness` data type.\n - The `com.google.calories.consumed` data type is now deprecated. Calorie consumption can be recorded with the `com.google.fitness.item` data type.\n - For more information on data types, see [Fitness Data Types](/fit/android/data-types).\n- Developers can retrieve daily aggregate step counts for use in areas such as Android Wear watch faces. For more information, see [Read daily total data](/fit/android/history#read_daily_total_data).\n\nMarch 2015\n\n[Google Play services 7.0](//developer.android.com/google/play-services/index.html)\nintroduces the following new Google Fit features:\n\n- The Google Fit API is now modularized so that you can choose which features to include in your app. This change significantly reduces the memory requirement for apps that enable Google Fit and affects how you access the APIs. For more information on how to update your code, see [Connect to the fitness service](/fit/android/get-started#step_5_connect_to_the_fitness_service).\n- The Fit platform now calculates distance. To access the data, use the `com.google.distance.delta` data type. For more information on data types, see [Fitness Data Types](/fit/android/data-types).\n- Developers can now read and write granular sleep data. This includes light sleep, deep sleep, REM, and awake activities. These granular activity types have been added to the [`FitnessActivities`](/android/reference/com/google/android/gms/fitness/FitnessActivities) enumerated type.\n - To insert sleep data, create a session of type [`FitnessActivities.SLEEP`](/android/reference/com/google/android/gms/fitness/FitnessActivities#SLEEP).\n - To detect granularity in your session, insert activity segments of types:\n - [`FitnessActivities.SLEEP_LIGHT`](/android/reference/com/google/android/gms/fitness/FitnessActivities#SLEEP_LIGHT)\n - [`FitnessActivities.SLEEP_DEEP`](/android/reference/com/google/android/gms/fitness/FitnessActivities#SLEEP_DEEP)\n - [`FitnessActivities.SLEEP_REM`](/android/reference/com/google/android/gms/fitness/FitnessActivities#SLEEP_REM)\n - [`FitnessActivities.SLEEP_AWAKE`](/android/reference/com/google/android/gms/fitness/FitnessActivities#SLEEP_AWAKE)\n - To read sleep data, query the sleep sessions for sleep activity segments as you would do with normal fitness activities."]]
