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 قد يمثّلان مصدر البيانات نفسه حتى إذا لم يكنا متساويين.

التنسيق الدقيق لرقم تعريف مصدر البيانات الذي أنشأه تطبيق Android هو: 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 number

أخيرًا، يتم إخفاء مفاتيح فك تشفير رقم مشروع المطوِّر والمعرِّف الفريد للجهاز عند قراءة أي عميل 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, obfuscated(id1) == obfuscated(id2).

device.version string سلسلة الإصدار لجهاز أو برنامج الجهاز
name string اسم مرئي للمستخدم النهائي لمصدر البيانات هذا.
type string وصف ثابت لنوع مصدر البيانات هذا. تشير هذه السمة إلى ما إذا كان مصدر البيانات هذا يُنتج بيانات أولية أو مشتقة.

في ما يلي القيم المقبولة:
  • "derived"
  • "raw"

الطُرق

إنشاء
إنشاء مصدر بيانات جديد فريد على مستوى جميع مصادر البيانات التي تنتمي إلى إلى هذا المستخدم.

مصدر البيانات هو مصدر فريد لبيانات جهاز الاستشعار. يمكن أن تكشف مصادر البيانات البيانات الأولية الواردة من أجهزة استشعار الأجهزة الموجودة على الأجهزة المحلية أو الأجهزة المصاحبة. هم أيضًا كشف البيانات المشتقة، التي يتم إنشاؤها عن طريق تحويل أو دمج بيانات أخرى المصادر. يمكن أن توجد مصادر بيانات متعددة لنفس نوع البيانات. كل البيانات نقطة في كل مجموعة بيانات يتم إدراجها أو قراءتها من خلال Fitness API ومصدر البيانات المرتبط بها.

ينتج كل مصدر بيانات تدفقًا فريدًا من تحديثات مجموعة البيانات، مع بمعرّف مصدر البيانات الفريد. لا تؤثر كل التغييرات التي يتم إجراؤها على مصدر البيانات في معرِّف مصدر البيانات، لكي يتم تجميع البيانات التي تم جمعها من خلال الإصدارات المُحدَّثة لا يزال من الممكن اعتبار أنّ التطبيق/الجهاز ينتمي إلى البيانات نفسها المصدر.

يتم تحديد مصادر البيانات باستخدام سلسلة أنشأها الخادم، استنادًا إلى على محتوى المصدر الذي يتم إنشاؤه dataStreamId في الحقل عند استدعاء هذه الطريقة. أُنشأها جون هنتر، الذي كان متخصصًا سيتم إنشاؤها تلقائيًا بواسطة الخادم بالتنسيق الصحيح. في حال حذف dataStreamId، فيجب أن يتطابق مع التنسيق الذي الخوادم. يضمّ هذا التنسيق مجموعة من بعض الحقول من ومصدر بيانات، ولها ترتيب محدد. وفي حال عدم التطابق، سيتم إدخال الطلب ستفشل مع ظهور خطأ.

تحديد نوع بيانات ليس نوعًا معروفًا (بدءًا من "com.google.") إلى إنشاء مصدر بيانات بنوع بيانات مخصّص. يمكن فقط للتطبيق الذي أنشأ هذه الأنواع قراءة أنواع البيانات المخصصة. تم إيقاف أنواع البيانات المخصّصة. استخدام أنواع البيانات القياسية بدلاً من ذلك.

بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، رقم مشروع مطوّر البرامج الذي تمت مصادقته عند إنشاء البيانات المصدر. يتم تشويش رقم مشروع المطوّر هذا عند قراءته. أي مطوّر آخر يقرأ أنواع البيانات العلنية
حذف
حذف مصدر البيانات المحدّد سيفشل الطلب إذا كانت البيانات المصدر على أي نقاط بيانات.
الحصول على
عرض مصدر البيانات المحدّد.
list
قائمة بجميع مصادر البيانات التي تكون مرئية للمطوّر، باستخدام OAuth والنطاقات المقدمة. إنّ القائمة ليست شاملة. قد يكون لدى المستخدم معلومات مصادر البيانات المرئية فقط للمطوّرين الآخرين، أو المكالمات التي تستخدم والنطاقات الأخرى.
تعديل
يعدّل مصدر البيانات المحدّد. dataStreamId، dataType وtype وdataStreamName و device من الخصائص باستثناء version، لا يمكن تعديله.

يتم تحديد مصادر البيانات من خلال dataStreamId.