APIهای Google Fit، از جمله Google Fit REST API، در سال 2026 منسوخ خواهند شد . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .
در اندروید شروع کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این راهنما نحوه شروع توسعه با Google Fit در اندروید را توضیح میدهد.
راهاندازی
قبل از شروع به ساخت برنامه خود، مراحل بخشهای زیر را انجام دهید.
دریافت حساب گوگل
برای استفاده از APIهای Google Fit، به یک حساب کاربری گوگل نیاز دارید. میتوانید یک حساب کاربری جدید ایجاد کنید یا از یک حساب کاربری موجود استفاده کنید. شاید بخواهید یک حساب کاربری جداگانه ایجاد کنید تا برنامه خود را از دیدگاه یک کاربر آزمایش کنید.
دریافت سرویسهای گوگل پلی
جدیدترین کتابخانه کلاینت برای سرویسهای گوگل پلی را روی میزبان توسعه خود دریافت کنید:
توصیه میکنیم برای ساخت یک برنامه با Fitness API از محیط توسعه اندروید استودیو استفاده کنید. برای جزئیات بیشتر در مورد نحوه ایجاد یک پروژه جدید و پیکربندی آن در اندروید استودیو، به ایجاد یک پروژه مراجعه کنید.
کتابخانه کلاینت سرویسهای گوگل پلی را اضافه کنید
در اندروید استودیو، فایل build.gradle مربوط به ماژول خود را باز کنید و کتابخانه کلاینت سرویسهای گوگل پلی را به عنوان یک وابستگی اضافه کنید:
این کار تضمین میکند که Gradle هنگام ساخت برنامه شما، به طور خودکار SDK مربوط به تناسب اندام را دانلود کند.
برنامه خود را بسازید و آزمایش کنید
پس از اتمام مراحل راهاندازی، میتوانید شروع به ساخت برنامه خود کنید. برای شروع، با انواع دادههایی که برنامه شما میتواند ذخیره و بخواند آشنا شوید. درباره کار با دادهها در Google Fit بیشتر بدانید.
یک کلاینت API ایجاد کنید و انواع دادههایی را که برنامه شما برای نوشتن یا خواندن دادهها به آنها نیاز دارد، اضافه کنید. نقاط پایانی زیر در دسترس هستند:
SensorsClient : به منابع مختلف دادههای سلامت و تندرستی از حسگرهای سختافزاری در دستگاه محلی و دستگاههای همراه دسترسی پیدا کنید.
RecordingClient : برای جمعآوری دادههای حسگر در پسزمینه با مصرف کم انرژی و همیشه روشن.
HistoryClient : درج، حذف و خواندن دادههای تاریخی در Google Fit.
شکل زیر جریان مجوزدهی حاصل را که کاربران هنگام درخواست مجوز تجربه میکنند، نشان میدهد:
شکل ۱. جریان مجوزدهی برای کاربران.
مجوزهای اندروید : کاربران قبل از دانلود برنامه شما، مجوزهای اندروید درخواست شده را مشاهده میکنند. پس از دانلود برنامه، هرگونه مجوز زمان اجرا مورد نیاز را درخواست میکند و کاربران این مجوزها را اعطا یا رد میکنند.
بررسی و اتصال : برنامه شما قبل از درخواست دسترسی به انواع داده دیگر، بررسی میکند که آیا مجوزها اعطا شدهاند یا خیر.
درخواست محدودههای OAuth : گوگل از کاربر میخواهد که محدودههای OAuth مورد نیاز برای انواع دادههایی که میخواهد به آنها دسترسی داشته باشد را به برنامه شما اعطا کند.
دسترسی اعمال شده : پس از اعطای مجوز توسط کاربر، برنامه شما میتواند به انواع دادههایی که متعلق به محدودههایی هستند که کاربر به آنها مجوز داده است، دسترسی پیدا کند.
تاریخ آخرین بهروزرسانی 2026-02-07 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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"]],["تاریخ آخرین بهروزرسانی 2026-02-07 بهوقت ساعت هماهنگ جهانی."],[],[]]
