Users.dataSources: update

منبع داده مشخص شده را به روز می کند. dataStreamId ، dataType ، type ، dataStreamName و ویژگی های device به استثنای version ، قابل تغییر نیستند.

منابع داده با dataStreamId آنها شناسایی می شوند. اکنون آن را امتحان کنید .

درخواست کنید

درخواست HTTP 

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

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مسیر
dataSourceId string شناسه جریان داده منبع داده برای به‌روزرسانی.
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 یک برنامه یا منبع داده ایجاد کرده است، به راحتی ارائه می شود.
dataStreamId string یک شناسه منحصر به فرد برای جریان داده تولید شده توسط این منبع داده. شناسه شامل:

  • سازنده، مدل و شماره سریال (UID) دستگاه فیزیکی.
  • نام یا نام بسته برنامه. نام بسته زمانی استفاده می شود که منبع داده توسط یک برنامه Android ایجاد شده باشد. شماره پروژه توسعه دهنده زمانی استفاده می شود که منبع داده توسط مشتری REST ایجاد شده باشد.
  • نوع منبع داده
  • نام جریان منبع داده.
توجه داشته باشید که همه ویژگی های منبع داده به عنوان بخشی از شناسه جریان استفاده نمی شود. به ویژه، از نسخه سخت افزار/برنامه استفاده نمی شود. این به ما امکان می‌دهد از طریق به‌روزرسانی‌های نسخه، همان جریان را حفظ کنیم. این همچنین به این معنی است که دو شیء DataSource ممکن است جریان داده یکسانی را نشان دهند، حتی اگر برابر نباشند.

فرمت دقیق شناسه جریان داده ایجاد شده توسط یک برنامه اندرویدی این است: type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName type:dataType.name :application.packageName :device.manufacturer :device.model :device.uid :dataStreamName

فرمت دقیق شناسه جریان داده ایجاد شده توسط مشتری REST این است: type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName type:dataType.name :developer project number :device.manufacturer :device.model:device.uid :dataStreamName

هنگامی که هر یک از فیلدهای اختیاری که شناسه جریان داده را تشکیل می دهند وجود نداشته باشد، از شناسه جریان داده حذف می شود. حداقل شناسه جریان داده قابل اجرا این خواهد بود: type:dataType.name:شماره پروژه توسعه دهنده

در نهایت، شماره پروژه توسعه‌دهنده و UID دستگاه هنگام خواندن توسط هر REST یا کلاینت Android که منبع داده را ایجاد نکرده است، مبهم می‌شود. فقط خالق منبع داده شماره پروژه توسعه دهنده را به صورت واضح و معمولی می بیند. این به این معنی است که یک کلاینت مجموعه متفاوتی از data_stream_ids را نسبت به مشتری دیگر با اعتبارنامه‌های متفاوت می‌بیند.

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