Las APIs de Google Fit, incluida la API de REST de Google Fit, dejarán de estar disponibles en 2026. A partir del 1 de mayo de 2024, los desarrolladores no podrán registrarse para usar estas APIs.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Grabación permite a tu app solicitar el almacenamiento automatizado de datos de sensores en un
de manera eficiente de la batería mediante la creación de suscripciones. Se asocia una suscripción
Se relaciona con una app para Android y consta de un tipo de datos de entrenamiento o datos específicos.
fuente.
Puedes crear varias suscripciones para diferentes tipos o fuentes de datos
en tu app. Google Fit almacena datos de entrenamiento de las suscripciones activas,
incluso cuando tu app no se está ejecutando, y restablece esas suscripciones cuando la
se reinicie el sistema.
Los datos registrados están disponibles en el historial de entrenamiento del usuario. Si también quieres
Para mostrar los datos de tu app en tiempo real, usa la
API de Sensors junto con la API de Grabación. Para grabar
de actividad física con metadatos de sesión, usa el
API de Sessions.
Suscribirse a los datos de actividad física
Para solicitar la recopilación en segundo plano de datos de sensores de tu app, usa la
RecordingClient.subscribe
como se muestra en el siguiente fragmento de código:
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 la suscripción se agregó correctamente, Google Fit almacenará los datos de entrenamiento
datos de tipo
TYPE_STEP_COUNT_DELTA
en el historial de entrenamiento en nombre de tu app. Esta suscripción aparece
una lista de suscripciones activas en tu app.
Para suscribirte a más tipos de datos de actividad física en tu aplicación, sigue los pasos en la
ejemplo anterior, pero proporcionar un tipo de datos de actividad física diferente cada vez.
Mostrar lista de suscripciones activas
Para obtener una lista de las suscripciones activas para tu app, usa la
RecordingClient.listSubscriptions
como se muestra en el siguiente fragmento de código:
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}");}});}
Anular la suscripción a los datos de actividad física
Para detener la recopilación de datos de sensores en tu app, usa la
RecordingClient.unsubscribe
como se muestra en el siguiente fragmento de código:
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.});}
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-25 (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```"]]