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 زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.