APIهای Google Fit، از جمله Google Fit REST API، در سال 2026 منسوخ خواهند شد . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Recording API به برنامه شما این امکان را میدهد تا با ایجاد اشتراک، ذخیره خودکار دادههای حسگر را به روشی کمتوان از باتری درخواست کند. یک اشتراک با یک برنامه Android مرتبط است و شامل یک نوع داده تناسب اندام یا یک منبع داده خاص است.
می توانید چندین اشتراک برای انواع داده یا منابع داده مختلف در برنامه خود ایجاد کنید. Google Fit دادههای تناسب اندام را از اشتراکهای فعال ذخیره میکند، حتی زمانی که برنامه شما اجرا نمیشود، و با راهاندازی مجدد سیستم، این اشتراکها را بازیابی میکند.
داده های ثبت شده در تاریخچه تناسب اندام کاربر موجود است. اگر همچنین میخواهید دادهها را در برنامه خود بهصورت بلادرنگ نشان دهید، از Sensors API همراه با Recording API استفاده کنید. برای ثبت داده های تناسب اندام با فراداده جلسه، از Sessions API استفاده کنید.
در داده های تناسب اندام مشترک شوید
برای درخواست جمعآوری پسزمینه دادههای حسگر در برنامه خود، از روش RecordingClient.subscribe استفاده کنید، همانطور که در قطعه کد زیر نشان داده شده است:
کاتلین
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)}
جاوا
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));
اگر اشتراک با موفقیت اضافه شود، Google Fit دادههای تناسب اندام از نوع TYPE_STEP_COUNT_DELTA را از طرف برنامه شما در سابقه تناسب اندام ذخیره میکند. این اشتراک در لیست اشتراک های فعال برنامه شما ظاهر می شود.
برای مشترک شدن در انواع بیشتری از داده های تناسب اندام در برنامه خود، مراحل مثال قبلی را دنبال کنید اما هر بار یک نوع داده تناسب اندام متفاوت ارائه دهید.
اشتراک های فعال را فهرست کنید
برای دریافت لیستی از اشتراکهای فعال برنامه خود، از روش RecordingClient.listSubscriptions استفاده کنید، همانطور که در قطعه کد زیر نشان داده شده است:
کاتلین
Fitness.getRecordingClient(this,GoogleSignIn.getAccountForExtension(this,fitnessOptions)).listSubscriptions().addOnSuccessListener{subscriptions->
for(scinsubscriptions){valdt=sc.dataTypeLog.i(TAG,"Active subscription for data type: ${dt.name}")}}
جاوا
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}");}});}
لغو اشتراک از داده های تناسب اندام
برای توقف جمع آوری داده های حسگر در برنامه خود، از روش RecordingClient.unsubscribe استفاده کنید، همانطور که در قطعه کد زیر نشان داده شده است:
کاتلین
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.}
جاوا
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.});}
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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```"]]