Les API Google Fit, y compris l'API REST Google Fit, seront abandonnées en 2026. Depuis le 1er mai 2024, les développeurs ne peuvent plus s'inscrire pour utiliser ces API.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Recording permet à votre application de demander le stockage automatisé des données de capteurs dans un
économe en batterie en créant des abonnements. Un abonnement est associé
avec une application Android, et il s'agit d'un type de données de fitness ou de données
source.
Vous pouvez créer plusieurs abonnements pour différents types ou sources de données
dans votre application. Google Fit stocke les données de remise en forme des abonnements actifs,
même lorsque votre application n'est pas en cours d'exécution, et restaure ces abonnements
le système redémarre.
Les données enregistrées sont disponibles dans l'historique de remise en forme de l'utilisateur. Si vous souhaitez également
pour afficher les données dans votre application en temps réel, utilisez le
L'API Sensors et l'API Recording. Pour enregistrer
données de fitness avec les métadonnées de session, utilisez la
API Sessions :
S'abonner aux données de remise en forme
Pour demander la collecte en arrière-plan des données des capteurs dans votre application, utilisez le
RecordingClient.subscribe
, comme indiqué dans l'extrait de code suivant:
Kotlin
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions))// This example shows subscribing to a DataType, across all possible data// sources. Alternatively, a specific DataSource can be used..subscribe(DataType.TYPE_STEP_COUNT_DELTA).addOnSuccessListener{Log.i(TAG,"Successfully subscribed!")}.addOnFailureListener{e->
Log.w(TAG,"There was a problem subscribing.",e)}
Java
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions))// This example shows subscribing to a DataType, across all possible// data sources. Alternatively, a specific DataSource can be used..subscribe(DataType.TYPE_STEP_COUNT_DELTA).addOnSuccessListener(unused->
Log.i(TAG,"Successfully subscribed!")).addOnFailureListener(e->
Log.w(TAG,"There was a problem subscribing.",e));
Si l'abonnement est bien ajouté, Google Fit stocke les données de fitness
données de type
TYPE_STEP_COUNT_DELTA
dans l'historique de remise en forme au nom de votre application. Cet abonnement figure dans le
liste des abonnements actifs pour votre application.
Pour vous abonner à d'autres types de données de fitness dans votre application, suivez les étapes décrites dans le
exemple précédent, mais fournir un type de données de remise en forme différent à chaque fois.
Lister les abonnements actifs
Pour obtenir la liste des abonnements actifs pour votre application, utilisez le
RecordingClient.listSubscriptions
, comme indiqué dans l'extrait de code suivant:
Kotlin
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions)).listSubscriptions().addOnSuccessListener{subscriptions->
for(scinsubscriptions){valdt=sc.dataTypeLog.i(TAG,"Active subscription for data type: ${dt.name}")}}
Java
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions)).listSubscriptions().addOnSuccessListener(subscriptions->{for(Subscriptionsc:subscriptions){DataTypedt=sc.getDataType();Log.i(TAG,"Active subscription for data type: ${dt.name}");}});}
Se désabonner des données de remise en forme
Pour arrêter la collecte des données des capteurs dans votre application, utilisez le
RecordingClient.unsubscribe
, comme indiqué dans l'extrait de code suivant:
Kotlin
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions))// This example shows unsubscribing from a DataType. A DataSource should// be used where the subscription was to a DataSource. Alternatively, if// the client doesn't maintain its subscription information, they can use// an element from the return value of listSubscriptions(), which is of// type Subscription..unsubscribe(DataType.TYPE_STEP_COUNT_DELTA).addOnSuccessListener{Log.i(TAG,"Successfully unsubscribed.")}.addOnFailureListener{e->
Log.w(TAG,"Failed to unsubscribe.")// Retry the unsubscribe request.}
Java
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions))// This example shows unsubscribing from a DataType. A DataSource// should be used where the subscription was to a DataSource.// Alternatively, if the client doesn’t maintain its subscription// information, they can use an element from the return value of// listSubscriptions(), which is of type Subscription..unsubscribe(DataType.TYPE_STEP_COUNT_DELTA).addOnSuccessListener(unused->
Log.i(TAG,"Successfully unsubscribed.")).addOnFailureListener(e->{Log.w(TAG,"Failed to unsubscribe.");// Retry the unsubscribe request.});}
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Recording API enables your app to automatically store sensor data in a battery-efficient way through subscriptions, which are linked to your app and specify a data type or source.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Fit retains fitness data from active subscriptions even when your app is inactive, and these subscriptions are automatically restored upon system restart.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage your active data subscriptions by listing existing ones and unsubscribing from specific data types as needed.\u003c/p\u003e\n"],["\u003cp\u003eTo display real-time data alongside recorded historical data in your app, consider using the Recording API in conjunction with the Sensors API.\u003c/p\u003e\n"]]],[],null,["# Record fitness data\n\nThe Recording API lets your app request automated storage of sensor data in a\nbattery-efficient manner by creating subscriptions. A subscription is associated\nwith an Android app and consists of a fitness data type or a specific data\nsource.\n\nYou can create multiple subscriptions for different data types or data sources\nin your app. Google Fit stores fitness data from active subscriptions,\neven when your app isn't running, and it restores these subscriptions when the\nsystem restarts.\n\nThe recorded data is available in the user's fitness history. If you also want\nto show the data in your app in real time, use the\n[Sensors API](/fit/android/sensors) together with the Recording API. To record\nfitness data with session metadata, use the\n[Sessions API](/fit/android/using-sessions).\n| **Note:** For best practices when you manage user data, see [Google Fit Developer and User Data Policy](/fit/policy).\n\nSubscribe to fitness data\n-------------------------\n\nTo request background collection of sensor data in your app, use the\n[`RecordingClient.subscribe`](/android/reference/com/google/android/gms/fitness/RecordingClient)\nmethod, as shown in the following code snippet: \n\n### Kotlin\n\n```kotlin\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n // This example shows subscribing to a DataType, across all possible data\n // sources. Alternatively, a specific DataSource can be used.\n .subscribe(DataType.TYPE_STEP_COUNT_DELTA)\n .addOnSuccessListener {\n Log.i(TAG, \"Successfully subscribed!\")\n }\n .addOnFailureListener { e -\u003e\n Log.w(TAG, \"There was a problem subscribing.\", e)\n }\n```\n\n### Java\n\n```java\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n // This example shows subscribing to a DataType, across all possible\n // data sources. Alternatively, a specific DataSource can be used.\n .subscribe(DataType.TYPE_STEP_COUNT_DELTA)\n .addOnSuccessListener(unused -\u003e\n Log.i(TAG, \"Successfully subscribed!\"))\n .addOnFailureListener( e -\u003e\n Log.w(TAG, \"There was a problem subscribing.\", e));\n```\n\nIf the subscription is added successfully, Google Fit stores fitness\ndata of type\n[`TYPE_STEP_COUNT_DELTA`](/android/reference/com/google/android/gms/fitness/data/DataType#TYPE_STEP_COUNT_DELTA)\nin the fitness history on behalf of your app. This subscription appears in the\nlist of active subscriptions for your app.\n\nTo subscribe to more types of fitness data in your app, follow the steps in the\nprevious example but provide a different fitness data type each time.\n| **Note:** Apps that run on Android 10 (API level 29) or higher must [get an Android permission](/fit/android/authorization#requesting_android_permissions) when they record some physical activity data types.\n\nList active subscriptions\n-------------------------\n\nTo get a list of the active subscriptions for your app, use the\n[`RecordingClient.listSubscriptions`](/android/reference/com/google/android/gms/fitness/RecordingClient)\nmethod, as shown in the following code snippet: \n\n### Kotlin\n\n```kotlin\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n .listSubscriptions()\n .addOnSuccessListener { subscriptions -\u003e\n for (sc in subscriptions) {\n val dt = sc.dataType\n Log.i(TAG, \"Active subscription for data type: ${dt.name}\")\n }\n }\n```\n\n### Java\n\n```java\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n .listSubscriptions()\n .addOnSuccessListener(subscriptions -\u003e {\n for (Subscription sc : subscriptions) {\n DataType dt = sc.getDataType();\n Log.i(TAG, \"Active subscription for data type: ${dt.name}\");\n }\n });\n}\n```\n\nUnsubscribe from fitness data\n-----------------------------\n\nTo stop the collection of sensor data in your app, use the\n[`RecordingClient.unsubscribe`](/android/reference/com/google/android/gms/fitness/RecordingClient)\nmethod, as shown in the following code snippet: \n\n### Kotlin\n\n```kotlin\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n // This example shows unsubscribing from a DataType. A DataSource should\n // be used where the subscription was to a DataSource. Alternatively, if\n // the client doesn't maintain its subscription information, they can use\n // an element from the return value of listSubscriptions(), which is of\n // type Subscription.\n .unsubscribe(DataType.TYPE_STEP_COUNT_DELTA)\n .addOnSuccessListener {\n Log.i(TAG,\"Successfully unsubscribed.\")\n }\n .addOnFailureListener { e-\u003e\n Log.w(TAG, \"Failed to unsubscribe.\")\n // Retry the unsubscribe request.\n }\n```\n\n### Java\n\n```java\nFitness.getRecordingClient(this, GoogleSignIn.getAccountForExtension(this, fitnessOptions))\n // This example shows unsubscribing from a DataType. A DataSource\n // should be used where the subscription was to a DataSource.\n // Alternatively, if the client doesn't maintain its subscription\n // information, they can use an element from the return value of\n // listSubscriptions(), which is of type Subscription.\n .unsubscribe(DataType.TYPE_STEP_COUNT_DELTA)\n .addOnSuccessListener(unused -\u003e\n Log.i(TAG,\"Successfully unsubscribed.\"))\n .addOnFailureListener(e -\u003e {\n Log.w(TAG, \"Failed to unsubscribe.\");\n // Retry the unsubscribe request.\n });\n}\n```"]]