APIهای Google Fit، از جمله Google Fit REST API، پس از 30 ژوئن 2025 دیگر در دسترس نخواهند بود . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .

برای دستورالعمل‌هایی که در مورد کدام API یا پلتفرم باید به آن مهاجرت کنید، از راهنمای مهاجرت Health Connect دیدن کنید. برای مقایسه Health Connect با APIهای Google Fit و APIهای وب Fitbit، از راهنمای مقایسه Health Connect دیدن کنید.

درباره Health Connect و نحوه ادغام با API بیشتر بیاموزید .

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Users.dataSources: create

یک منبع داده جدید ایجاد می کند که در همه منابع داده متعلق به این کاربر منحصر به فرد است.

منبع داده منبع منحصر به فردی از داده های حسگر است. منابع داده می توانند داده های خام حاصل از حسگرهای سخت افزاری در دستگاه های محلی یا همراه را در معرض نمایش قرار دهند. آنها همچنین می توانند داده های مشتق شده را که از طریق تبدیل یا ادغام سایر منابع داده ایجاد شده اند، در معرض دید قرار دهند. چندین منبع داده می تواند برای یک نوع داده وجود داشته باشد. هر نقطه داده در هر مجموعه داده درج شده یا خوانده شده از Fitness API یک منبع داده مرتبط دارد.

هر منبع داده یک جریان منحصر به فرد از به روز رسانی مجموعه داده ها را با یک شناسه منبع داده منحصر به فرد تولید می کند. همه تغییرات در منبع داده بر شناسه جریان داده تأثیر نمی‌گذارد، بنابراین داده‌های جمع‌آوری‌شده توسط نسخه‌های به‌روزرسانی‌شده همان برنامه/دستگاه همچنان می‌تواند متعلق به همان منبع داده در نظر گرفته شود.

منابع داده با استفاده از یک رشته تولید شده توسط سرور، بر اساس محتویات منبع در حال ایجاد، شناسایی می شوند. هنگام فراخوانی این روش، فیلد dataStreamId نباید تنظیم شود. به طور خودکار توسط سرور با فرمت صحیح تولید می شود. اگر dataStreamId تنظیم شده باشد، باید با فرمتی که سرور ایجاد می کند مطابقت داشته باشد. این قالب ترکیبی از چند فیلد از منبع داده است و دارای ترتیب خاصی است. اگر مطابقت نداشته باشد، درخواست با یک خطا ناموفق خواهد بود.

تعیین یک DataType که نوع شناخته شده ای نیست (با "com.google" شروع می شود) یک DataSource با یک نوع داده سفارشی ایجاد می کند. انواع داده های سفارشی فقط توسط برنامه ای که آنها را ایجاد کرده قابل خواندن هستند. انواع داده های سفارشی منسوخ شده اند. به جای آن از انواع داده های استاندارد استفاده کنید.

علاوه بر فیلدهای منبع داده موجود در شناسه منبع داده، شماره پروژه توسعه دهنده که هنگام ایجاد منبع داده احراز هویت می شود نیز گنجانده شده است. این شماره پروژه توسعه‌دهنده هنگام خواندن توسط هر توسعه‌دهنده دیگری که انواع داده‌های عمومی را می‌خواند مبهم می‌شود. اکنون آن را امتحان کنید .

درخواست کنید

درخواست HTTP

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

پارامترها

نام پارامتر	ارزش	توضیحات
پارامترهای مسیر
`userId`	`string`	منبع داده را برای شخص شناسایی شده ایجاد کنید. از `me` برای نشان دادن کاربر تایید شده استفاده کنید. در حال حاضر فقط `me` پشتیبانی می شود.

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:

دامنه
`https://www.googleapis.com/auth/fitness.activity.write`
`https://www.googleapis.com/auth/fitness.location.write`
`https://www.googleapis.com/auth/fitness.body.write`
`https://www.googleapis.com/auth/fitness.nutrition.write`
`https://www.googleapis.com/auth/fitness.blood_pressure.write`
`https://www.googleapis.com/auth/fitness.blood_glucose.write`
`https://www.googleapis.com/auth/fitness.oxygen_saturation.write`
`https://www.googleapis.com/auth/fitness.body_temperature.write`
`https://www.googleapis.com/auth/fitness.reproductive_health.write`

برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.

درخواست بدن

در بدنه درخواست، یک منبع Users.dataSources با ویژگی های زیر ارائه کنید:

نام ملک	ارزش	توضیحات
خواص مورد نیاز
`application`	`nested object`	اطلاعاتی در مورد برنامه ای که داده های حسگر را به پلتفرم تغذیه می کند.
`application. name`	`string`	نام این اپلیکیشن این برای مشتریان REST لازم است، اما ما منحصر به فرد بودن این نام را اعمال نمی کنیم. برای سایر توسعه دهندگانی که می خواهند تشخیص دهند کدام REST یک برنامه یا منبع داده ایجاد کرده است، به راحتی ارائه می شود.
`dataType`	`nested object`	نوع داده طرحی را برای جریانی از داده‌ها که توسط Fitness API جمع‌آوری، درج یا از آن درخواست می‌شود، تعریف می‌کند.
`dataType. field[]`	`list`	یک فیلد یک بعد از یک نوع داده را نشان می دهد.
`dataType.field[]. format`	`string`	فرمت های مختلف پشتیبانی شده برای هر فیلد در یک نوع داده. مقادیر قابل قبول عبارتند از: " `blob` " " `floatList` " " `floatPoint` " " `integer` " " `integerList` " " `map` " " `string` "
`dataType.field[]. name`	`string`	نام و قالب داده ها را مشخص می کند. برخلاف نام‌های نوع داده، نام فیلدها دارای فضای نام نیستند و فقط باید در نوع داده منحصر به فرد باشند.
`dataType. name`	`string`	هر نوع داده دارای یک نام منحصر به فرد با فضای نام است. همه انواع داده ها در فضای نام com.google به عنوان بخشی از پلتفرم به اشتراک گذاشته می شوند.
`device`	`nested object`	نمایش یک دستگاه یکپارچه (مانند تلفن یا پوشیدنی) که می تواند حسگرها را نگه دارد.
`device. manufacturer`	`string`	سازنده محصول/سخت افزار.
`device. model`	`string`	نام مدل قابل مشاهده توسط کاربر نهایی برای دستگاه.
`device. type`	`string`	ثابت نشان دهنده نوع دستگاه. مقادیر قابل قبول عبارتند از: " `chestStrap` " " `headMounted` " " `phone` " " `scale` " " `smartDisplay` " " `tablet` " " `unknown` " " `watch` "
`device. uid`	`string`	شماره سریال یا شناسه منحصر به فرد دیگر برای سخت افزار. این فیلد هنگام خواندن توسط هر مشتری REST یا Android که منبع داده را ایجاد نکرده است، مبهم می شود. فقط خالق منبع داده، فیلد uid را به صورت واضح و عادی می بیند. ابهام برابری را حفظ می کند. یعنی دو شناسه داده شود، اگر id1 == id2، مبهم (id1) == مبهم (id2).
`device. version`	`string`	رشته نسخه برای سخت افزار/نرم افزار دستگاه.
`type`	`string`	یک ثابت که نوع این منبع داده را توصیف می کند. نشان می دهد که آیا این منبع داده داده های خام یا مشتق شده را تولید می کند. مقادیر قابل قبول عبارتند از: " `derived` " " `raw` "

پاسخ

در صورت موفقیت آمیز بودن، این روش یک منبع Users.dataSources را در بدنه پاسخ برمی گرداند.

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.