Users.dataSources

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

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

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

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع 

{
  "dataStreamId": string,
  "name": string,
  "dataStreamName": string,
  "type": string,
  "dataType": {
    "name": string,
    "field": [
      {
        "name": string,
        "format": string,
        "optional": boolean
      }
    ]
  },
  "device": {
    "uid": string,
    "type": string,
    "version": string,
    "model": string,
    "manufacturer": string
  },
  "application": {
    "packageName": string,
    "version": string,
    "detailsUrl": string,
    "name": string
  },
  "dataQualityStandard": [
    string
  ]
}
نام ملک ارزش توضیحات یادداشت ها
application nested object اطلاعاتی در مورد برنامه ای که داده های حسگر را به پلتفرم تغذیه می کند.
application. detailsUrl string یک URI اختیاری که می تواند برای پیوند دادن به برنامه استفاده شود.
application. name string نام این اپلیکیشن این برای مشتریان REST لازم است، اما ما منحصر به فرد بودن این نام را اعمال نمی کنیم. برای سایر توسعه دهندگانی که می خواهند تشخیص دهند کدام REST یک برنامه یا منبع داده ایجاد کرده است، به راحتی ارائه می شود.
application. packageName string نام بسته برای این برنامه. هنگامی که توسط برنامه های Android ایجاد می شود، به عنوان یک شناسه منحصر به فرد استفاده می شود، اما توسط مشتریان REST قابل تعیین نیست. مشتریان REST به جای packageName، شماره پروژه توسعه‌دهنده‌شان را در شناسه‌های جریان داده منبع داده منعکس می‌کنند.
application. version string نسخه برنامه. هر زمان که برنامه به گونه ای تغییر کند که بر محاسبه داده ها تأثیر بگذارد، باید این فیلد را به روز کنید.
dataQualityStandard[] list این فیلد را پر نکنید. هرگز در پاسخ های پلتفرم پر نمی شود و در پرس و جوها نادیده گرفته می شود. در نسخه بعدی به طور کامل حذف خواهد شد.
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 را نسبت به مشتری دیگر با اعتبارنامه‌های متفاوت می‌بیند.

dataStreamName string نام جریان به طور منحصربه‌فردی این منبع داده خاص را در میان سایر منابع داده از همان نوع از همان تولیدکننده اصلی شناسایی می‌کند. تنظیم نام جریان اختیاری است، اما باید زمانی انجام شود که یک برنامه دو جریان را برای یک نوع داده نشان دهد، یا زمانی که دستگاهی دارای دو حسگر معادل است.
dataType nested object نوع داده طرحی را برای جریانی از داده‌ها که توسط Fitness API جمع‌آوری، درج یا از آن درخواست می‌شود، تعریف می‌کند.
dataType. field[] list یک فیلد یک بعد از یک نوع داده را نشان می دهد.
dataType.field[]. format string فرمت های مختلف پشتیبانی شده برای هر فیلد در یک نوع داده.

مقادیر قابل قبول عبارتند از:
  • " blob "
  • " floatList "
  • " floatPoint "
  • " integer "
  • " integerList "
  • " map "
  • " string "
dataType.field[]. name string نام و قالب داده ها را مشخص می کند. برخلاف نام‌های نوع داده، نام فیلدها دارای فضای نام نیستند و فقط باید در نوع داده منحصر به فرد باشند.
dataType.field[]. optional boolean
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 رشته نسخه برای سخت افزار/نرم افزار دستگاه.
name string یک نام قابل مشاهده برای کاربر نهایی برای این منبع داده.
type string یک ثابت که نوع این منبع داده را توصیف می کند. نشان می دهد که آیا این منبع داده داده های خام یا مشتق شده را تولید می کند.

مقادیر قابل قبول عبارتند از:
  • " derived "
  • " raw "

روش ها

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

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

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

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

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

علاوه بر فیلدهای منبع داده موجود در شناسه منبع داده، شماره پروژه توسعه دهنده که هنگام ایجاد منبع داده احراز هویت می شود نیز گنجانده شده است. این شماره پروژه توسعه‌دهنده هنگام خواندن توسط هر توسعه‌دهنده دیگری که انواع داده‌های عمومی را می‌خواند مبهم می‌شود.
حذف کنید
منبع داده مشخص شده را حذف می کند. اگر منبع داده حاوی نقاط داده باشد، درخواست با شکست مواجه خواهد شد.
دریافت کنید
منبع داده مشخص شده را برمی گرداند.
فهرست
با استفاده از محدوده های OAuth ارائه شده، تمام منابع داده ای را که برای توسعه دهنده قابل مشاهده است فهرست می کند. فهرست جامع نیست. کاربر ممکن است منابع داده خصوصی داشته باشد که فقط برای توسعه دهندگان دیگر قابل مشاهده است، یا تماس هایی با استفاده از حوزه های دیگر داشته باشد.
به روز رسانی کنید
منبع داده مشخص شده را به روز می کند. ویژگی‌های dataStreamId ، dataType ، type ، dataStreamName و device به استثنای version ، قابل تغییر نیستند.

منابع داده با dataStreamId آنها شناسایی می شوند.