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
  ]
}

اسم الموقع	القيمة	الوصف	Notes
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:رقم مشروع المطور أخيرًا، يتم تشويش رقم مشروع المطوّر والمعرّف الفريد للجهاز عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر رقم مشروع المطوِّر بشكل واضح وعادي إلا لمنشئ مصدر البيانات. وهذا يعني أنّ العميل سيرى مجموعة من data_stream_ids تختلف عن مجموعة أخرى من أجل استخدام بيانات اعتماد مختلفة.
dataStreamName	string	ويحدِّد اسم مصدر البيانات مصدر البيانات المعيّن هذا بشكلٍ فريد من بين مصادر البيانات الأخرى من النوع نفسه والتابع للمنتج الأساسي نفسه. إنّ ضبط اسم مصدر البيانات هو إجراء اختياري، ولكن يجب تنفيذه عندما يعرض التطبيق مصدرَي بيانات لنوع البيانات نفسه أو عندما يحتوي الجهاز على أدوات استشعار مكافئة.
dataType	nested object	يحدّد نوع البيانات مخططًا لتدفق البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات اللياقة البدنية أو إدراجها فيها أو الاستعلام عنها.
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 لم ينشئ مصدر البيانات. ولن يظهر الحقل المعرّف الفريد بشكل واضح وعادي إلا لمنشئ مصدر البيانات. يحافظ التشويش على المساواة؛ أي، وفقًا لرقم تعريفي، إذا كان id1 == id2، obfuscated(id1) == obfuscated(id2).
device.version	string	سلسلة الإصدار لجهاز/برنامج الجهاز
name	string	اسم مرئي للمستخدم لمصدر البيانات هذا.
type	string	رقم ثابت يصف نوع مصدر البيانات هذا. يشير إلى ما إذا كان مصدر البيانات هذا سينتج بيانات أولية أو مشتقة. القيم المقبولة هي: "derived" "raw"

الطُرق

إنشاء

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

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

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

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

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

بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، يتم تضمين رقم مشروع المطوِّر الذي تمت المصادقة عليه عند إنشاء مصدر البيانات. يتم تشويش رقم مشروع المطوّر هذا عند قراءته من قِبل أي مطوّر آخر يقرأ أنواع البيانات العامة.

حذف

حذف مصدر البيانات المحدّد سيفشل الطلب إذا كان مصدر البيانات يحتوي على أي نقاط بيانات.

الحصول على

لعرض مصدر البيانات المحدّد.

list

تسرد قائمة بجميع مصادر البيانات المرئية للمطوّر، باستخدام نطاقات OAuth المتوفرة. القائمة ليست شاملة، وقد يكون لدى المستخدم مصادر بيانات خاصة لا تظهر إلا للمطوّرين الآخرين، أو قد يكون للمستخدم مكالمات تستخدم نطاقات أخرى.

تعديل

لتعديل مصدر البيانات المحدَّد. لا يمكن تعديل السمات dataStreamId وdataType وtype وdataStreamName وdevice باستثناء version.

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