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 project number أخيرًا، يتم إخفاء مفاتيح فك تشفير رقم مشروع مطوّر البرامج ومعرّف الجهاز الفريد (UID) عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. لن يتمكّن أحد من الاطّلاع على رقم مشروع مطوّر البرامج إلا بشكل واضح وطبيعي فقط. هذا يعني أنّ العميل سيرى مجموعة مختلفة من data_stream_ids مقارنةً ببرنامج آخر لديه بيانات اعتماد مختلفة.
dataStreamName	string	يحدِّد اسم مصدر البيانات هذا مصدر البيانات المحدّد بشكل فريد من بين مصادر بيانات أخرى من النوع نفسه من المنتج الأساسي نفسه. إنّ ضبط اسم مصدر البيانات يكون اختياريًا، ولكن يجب تنفيذه عندما يعرض التطبيق مصدرَي بيانات لنوع البيانات نفسه أو عندما يحتوي الجهاز على جهازَي استشعار مماثلَين.
dataType	nested object	يحدد نوع البيانات المخطط لمصدر البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات Fitness أو إدراجها فيها أو البحث عنها.
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"

الطُرق

إنشاء

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

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

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

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

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

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

حذف

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

الحصول

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

list

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

تحديث

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

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