رابطهای برنامهنویسی کاربردی (API) گوگل فیت منسوخ شدهاند و قرار است در اواخر سال ۲۰۲۶ به پایان سرویسدهی خود برسند. گوگل چندین محصول و خدمات سلامت و تندرستی ارائه میدهد تا به کاربران شما کمک کند پس از منسوخ شدن، به اهداف خود دست یابند.
احتیاط: API گوگل فیت (شامل REST API) فقط تا پایان سال ۲۰۲۶ پشتیبانی خواهد شد. توصیه میکنیم برای ادغامهای مبتنی بر فضای ابری به API گوگل هلث یا برای ردیابی قدمها و برنامههای موبایلمحور به Health Connect مهاجرت کنید.
دستورالعملهای زیر به شما نشان میدهند که بر اساس نحوهی استفادهتان از APIهای Google Fit، به کدام سرویس مهاجرت کنید.
مسیرهای مهاجرت توصیه شده
انتخاب API شما باید بر اساس نوع برنامه و نیازهای خاص داده شما باشد.
بر اساس نوع برنامه
| نوع برنامه | مسیر پیشنهادی | دلیل اصلی |
|---|---|---|
| اپلیکیشن ردیابی قدمها | ارتباط با سلامت | خواندن دادههای جمعآوریشده از منابع مختلف با محوریت موبایل. |
| اپلیکیشن همراه ردیابهای تناسب اندام | رابط برنامهنویسی کاربردی گوگل هلث | پلتفرم وبمحور که برای ادغام کاربر به OAuth نیاز دارد. |
| پلتفرم سلامت و تناسب اندام | رابط برنامهنویسی کاربردی گوگل هلث و هلث کانکت | برای دادههای دستگاههای Fitbit/Google از API Google Health و برای دادههای تجمیعشده روی دستگاه از Health Connect استفاده کنید. |
با ادغام فعلی
| ادغام فعلی | مسیر پیشنهادی | در دسترس بودن |
|---|---|---|
| گوگل فیت (اندروید و REST API) | رابط برنامهنویسی کاربردی گوگل هلث | موجود است |
| خواندن گامهای برداشتهشده از طریق موبایل (با استفاده از API ضبط گوگل فیت) | ارتباط با سلامت | موجود است |
| رابط برنامهنویسی کاربردی تناسب اندام (Fit API) در سیستمعامل Wear OS | خدمات درمانی | موجود است |
| رابط برنامهنویسی کاربردی وب فیتبیت | رابط برنامهنویسی کاربردی گوگل هلث | موجود است |
| API ضبط در موبایل | ارتباط با سلامت | موجود است |
| ارتباط با سلامت | ادغام موجود را حفظ کنید یا API سلامت گوگل را اضافه کنید | موجود است |
مقایسههای فنی
بخشهای زیر مقایسهای فنی بین APIهای Google Fit، Google Health API و Health Connect ارائه میدهند تا به شما در انتخاب مسیر مهاجرت مناسب کمک کنند.
API تناسب اندام در مقابل API سلامت گوگل
اگر برنامه شما یک پلتفرم مبتنی بر وب است یا به تعاملات سرور به سرور (S2S) نیاز دارد، از این مسیر استفاده کنید.
| ویژگی | API متناسب (اندروید/REST) | رابط برنامهنویسی کاربردی گوگل هلث |
|---|---|---|
| راهاندازی پروژه | کنسول ابری گوگل | ایجاد پروژه گوگل کلود |
| پیکربندی OAuth | نوع اپلیکیشن اندروید یا وب | نوع برنامه وب |
| معماری داده | انواع پیشوند com.google | انواع دادههای یکپارچه API سلامت گوگل |
| ثبت نام برنامه | ایجاد پروژه گوگل کلود | ایجاد پروژه Google Cloud و فعال کردن Google Health API |
API متناسب با نیازهای شما در مقابل Health Connect
از این مسیر برای برنامههای اندروید مخصوص موبایل که معیارهای دستگاه محلی را میخوانند، استفاده کنید.
| ویژگی | API مناسب برای اندروید | ارتباط با سلامت |
|---|---|---|
| ثبت نام | کنسول ابری گوگل | اعلامیه پروژه فروشگاه Play و برنامههای سلامت |
| احراز هویت | OAuth 2.0 مورد نیاز است | بدون نیاز به OAuth (مجوزهای روی دستگاه) |
| ذخیرهسازی دادهها | ابر-محور | دستگاه محور (روی دستگاه) |
| مخاطب | توسعهدهندگان قدیمی اندروید | توسعهدهندگان موبایل اندروید مدرن |
| مجوزها | دامنههای OAuth | مجوزهای مانیفست اندروید |
ادغامهای API متناسب
بخشهای زیر راهنماییهایی در مورد مهاجرت از هر یک از APIهای Google Fit ارائه میدهند. اگر ادغام شما شامل عناصر رابط کاربری است که به برنامه Google Fit متصل میشوند، برای راهنمایی بیشتر به دستورالعملهای ادغام برنامه Fit مراجعه کنید.
برنامههایی که از Fit Recording API برای ثبت مراحل استفاده میکنند
API ضبط تناسب اندام به برنامه شما اجازه میدهد تا با ایجاد اشتراکها، درخواست ذخیرهسازی خودکار دادههای حسگر را به شیوهای با مصرف بهینه باتری ارائه دهد. هر اشتراک، یک برنامه اندروید را به یک نوع داده تناسب اندام یا منبع داده خاص متصل میکند و نوع داده Step معمولاً برای ثبت گامها استفاده میشود.
برای مهاجرت از Fit Recording API، این مراحل را دنبال کنید:
| تلفن | بپوشید |
| از خدمات درمانی استفاده کنید:
برای اطلاعات بیشتر در مورد تفاوتهای بین این دو، به مستندات خدمات درمانی مراجعه کنید. |
برنامههایی که از API تاریخچه برای خواندن یا نوشتن دادهها در فروشگاه تناسب اندام استفاده میکنند
رابط برنامهنویسی کاربردی تاریخچه (History API) به برنامه شما اجازه میدهد تا عملیات عمدهای را روی فروشگاه تناسب اندام انجام دهد. این عملیات شامل خواندن، درج، بهروزرسانی و حذف دادههای سلامت و تندرستی تاریخی است.
برای مهاجرت از History API، این مراحل را دنبال کنید:
| تلفن | بپوشید |
قابل اجرا نیست. از Health Connect از طریق برنامه تلفن همراه خود استفاده کنید و نه از طریق دستگاه پوشیدنی. |
برنامههایی که از API سنسور برای نمایش دادههای تناسب اندام در لحظه استفاده میکنند
رابط برنامهنویسی کاربردی حسگر (Sensor API) به شما امکان میدهد دادههای خام حسگر را در برنامه خود به صورت بلادرنگ (real time) بخوانید. رابط برنامهنویسی کاربردی حسگر (Sensor API) موارد زیر را انجام میدهد:
- منابع داده موجود در دستگاه و دستگاههای همراه را فهرست میکند.
- شنوندهها را برای دریافت دادههای خام حسگر ثبت میکند.
- ثبت نام شنوندهها را لغو میکند تا دیگر دادههای خام حسگر را دریافت نکنند.
برای مهاجرت از API سنسور، این مراحل را دنبال کنید:
| تلفن | بپوشید |
استفاده از حسگرها ، API ارائه دهنده موقعیت مکانی Fused | استفاده از سرویسهای سلامت در Wear OS:
|
برنامههایی که از Session API برای ارائه خلاصه فعالیتها استفاده میکنند
جلسات (session) نشاندهنده یک بازه زمانی هستند که کاربران در طی آن یک فعالیت تناسب اندام انجام میدهند.
رابط برنامهنویسی کاربردی Session به برنامه شما اجازه میدهد تا جلساتی را در فروشگاه تناسب اندام ایجاد کند.
برای مهاجرت از Session API، این مراحل را دنبال کنید:
| تلفن | بپوشید |
شروع/توقف: قابل اجرا نیست. برنامه باید وضعیت جلسات جاری را به صورت داخلی پیگیری کند. خواندن/نوشتن: انتقال به رابط برنامهنویسی کاربردی گوگل هلث . | شروع/توقف: استفاده از خدمات درمانی (ExerciseClient) خواندن/نوشتن: از Health Connect با برنامه تلفن همراه خود استفاده کنید. برای گردشهای کاری خاص، موارد زیر را توصیه میکنیم:
|
برنامههایی که از Goals API استفاده میکنند
اهداف، اهدافی در برنامه Google Fit هستند که کاربران میتوانند برای معیارهای خود مانند تعداد قدمها و امتیازهای قلب تعیین کنند. پلتفرم Fit اهداف آنها را ثبت میکند و فعالیت روزانه آنها را با استفاده از Goals API پیگیری میکند.
| تلفن | بپوشید |
| هیچ API جایگزینی در دسترس نیست. | هیچ API جایگزینی در دسترس نیست. |
برنامههایی که از BLE API استفاده میکنند
برنامه شما میتواند دستگاههای بلوتوث کممصرف (BLE) موجود را پیدا کند و دادههای حسگر را با استفاده از BLE API در پلتفرم Google Fit وارد کند.
برای مهاجرت از BLE API این مراحل را دنبال کنید:
| تلفن | بپوشید |
| مستقیماً از API های بلوتوث اندروید استفاده کنید. | مستقیماً از API های بلوتوث اندروید استفاده کنید. |
ویژگیهای منسوخشده
ویژگیهای زیر جایگزین مستقیم API ندارند. از APIهای استاندارد اندروید توصیهشده استفاده کنید:
- API حسگر : از چارچوب حسگرهای اندروید یا API ارائهدهنده موقعیت مکانی Fused برای دادههای خام بلادرنگ استفاده کنید.
- API اهداف : هیچ API جایگزینی در دسترس نیست. ردیابی هدف و اهداف فعالیت روزانه را در منطق برنامه خود مدیریت کنید.
- رابط برنامهنویسی کاربردی بلوتوث کممصرف (BLE) : از رابطهای برنامهنویسی کاربردی بلوتوث اندروید مستقیماً برای ارتباط با سختافزار استفاده کنید.
ادغام برنامههای متناسب
اگر برنامه شما برای اشتراکگذاری دادهها به Google Fit متصل میشود، راهنمای مربوط به انتقال کاربران فعلی و جدید به Health Connect یا Google Health API را در این بخشها دنبال کنید:
کاربران فعلی برنامه شما
اگر رابط کاربری برنامه شما شامل راهی برای اتصال کاربران به Google Fit باشد (یا اگر برنامه شما در لیست برنامههای سازگار با Google Fit قرار داشته باشد)، میتوانید ادغام برنامه Fit خود را برای کاربران فعلی ادامه دهید.
ما این بخش را با اطلاعاتی در مورد زمان لغو یکپارچهسازی برنامه Fit شما و بهترین گزینههای شما برای حفظ تجربه کاربریتان، بهروزرسانی خواهیم کرد. در عین حال، میتوانید با ما در ارتباط باشید .
| این کار را انجام دهید | این کار را نکن |
| Health Connect یا Google Health API را به عنوان یک گزینه جدید در برنامه خود ارائه دهید. روی مزایای کاربر مانند دادهها و بینشهای غنیتر، حریم خصوصی و امنیت تمرکز کنید.
| از کاربران بخواهید که از Google Fit جدا شوند.
|
کاربران جدید برنامه شما
برای ارائه تجربهای مشابه به کاربران جدید برنامهتان، توصیه میکنیم آن را با Health Connect یا Google Health API یکپارچه کنید.
Health Connect دسترسی به منابع و انواع جدید داده را فراهم میکند تا تجربهای غنیتر را برای کاربران فراهم کند و دادهها به طور ایمن روی دستگاه ذخیره شوند. Google Health API یک پلتفرم وبمحور برای دادههای Fitbit و دستگاههای Google فراهم میکند.
| این کار را انجام دهید | این کار را نکن |
| Health Connect یا Google Health API را در جریان راهاندازی برنامه خود قرار دهید. | Fit را به عنوان اپلیکیشنی ارائه دهید که کاربران میتوانند پس از در دسترس قرار گرفتن Health Connect به آن متصل شوند. |