تعريف مصدر فريد لبيانات جهاز الاستشعار. يمكن أن تكشف مصادر البيانات البيانات الأولية الواردة من أدوات الاستشعار في الأجهزة على الأجهزة المحلية أو المصاحبة. يمكنها أيضًا الكشف عن البيانات المشتقة، التي تم إنشاؤها عن طريق تحويل أو دمج مصادر بيانات أخرى. يمكن أن توجد مصادر بيانات متعددة لنوع البيانات نفسه. ولكل نقطة بيانات يتم إدراجها في هذه الخدمة أو قراءتها مصدر بيانات مرتبط بها.
يحتوي مصدر البيانات على معلومات كافية لتعريف بياناته بشكل فريد، بما في ذلك الجهاز والتطبيق الذي جمع البيانات و/أو حوّلها. وتحتوي أيضًا على بيانات وصفية مفيدة، مثل إصدارات الأجهزة والتطبيقات، ونوع الجهاز.
ينشئ كل مصدر بيانات مصدرًا فريدًا من البيانات بمعرّف فريد. ولا تؤثر بعض التغييرات في مصدر البيانات في معرّف مصدر البيانات، لذا سيظل من الممكن اعتبار البيانات التي يتم جمعها من خلال الإصدارات المعدّلة من التطبيق/الجهاز نفسه تابعة لمصدر البيانات نفسه.
للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.
تمثيلات الموارد
{ "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 |
معرّف فريد لمصدر البيانات الذي ينشئه مصدر البيانات هذا. يتضمّن المعرّف ما يلي:
التنسيق الدقيق لرقم تعريف مصدر البيانات الذي تم إنشاؤه من خلال تطبيق Android هو: type:dataType.name التنسيق الدقيق لرقم تعريف مصدر البيانات الذي أنشأه عميل REST هو: type:dataType.name في حال عدم توفّر أي من الحقول الاختيارية التي تشكِّل رقم تعريف مصدر البيانات، سيتم حذفها من رقم تعريف مصدر البيانات. سيكون رقم تعريف مصدر البيانات الأدنى القابل للتطبيق هو: type:dataType.name:رقم مشروع المطور أخيرًا، يتم تشويش رقم مشروع المطوّر والمعرّف الفريد للجهاز عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر رقم مشروع المطوِّر بشكل واضح وعادي إلا لمنشئ مصدر البيانات. وهذا يعني أنّ العميل سيرى مجموعة من data_stream_ids تختلف عن مجموعة أخرى من أجل استخدام بيانات اعتماد مختلفة. |
|
dataStreamName |
string |
ويحدِّد اسم مصدر البيانات مصدر البيانات المعيّن هذا بشكلٍ فريد من بين مصادر البيانات الأخرى من النوع نفسه والتابع للمنتج الأساسي نفسه. إنّ ضبط اسم مصدر البيانات هو إجراء اختياري، ولكن يجب تنفيذه عندما يعرض التطبيق مصدرَي بيانات لنوع البيانات نفسه أو عندما يحتوي الجهاز على أدوات استشعار مكافئة. | |
dataType |
nested object |
يحدّد نوع البيانات مخططًا لتدفق البيانات التي يتم جمعها من خلال واجهة برمجة تطبيقات اللياقة البدنية أو إدراجها فيها أو الاستعلام عنها. | |
dataType.field[] |
list |
يمثل الحقل بُعدًا واحدًا من نوع البيانات. | |
dataType.field[].format |
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 |
ثابت يمثّل نوع الجهاز.
القيم المقبولة هي:
|
|
device.uid |
string |
الرقم التسلسلي أو معرّف فريد آخر للجهاز يتم تشويش هذا الحقل عند قراءته من قِبل أي عميل REST أو Android لم ينشئ مصدر البيانات. ولن يظهر الحقل المعرّف الفريد بشكل واضح وعادي إلا لمنشئ مصدر البيانات. يحافظ التشويش على المساواة؛ أي، وفقًا لرقم تعريفي، إذا كان id1 == id2، obfuscated(id1) == obfuscated(id2). |
|
device.version |
string |
سلسلة الإصدار لجهاز/برنامج الجهاز | |
name |
string |
اسم مرئي للمستخدم لمصدر البيانات هذا. | |
type |
string |
رقم ثابت يصف نوع مصدر البيانات هذا. يشير إلى ما إذا كان مصدر البيانات هذا سينتج بيانات أولية أو مشتقة.
القيم المقبولة هي:
|
الطُرق
- إنشاء
- تُنشئ مصدر بيانات جديدًا فريدًا على مستوى جميع مصادر البيانات التي تنتمي إلى
هذا المستخدم.
مصدر البيانات هو مصدر فريد لبيانات أداة الاستشعار. يمكن لمصادر البيانات الكشف عن البيانات الأولية الواردة من أدوات استشعار الأجهزة على الأجهزة المحلية أو المرافقة. يمكنها أيضًا الكشف عن البيانات المشتقة، التي تم إنشاؤها عن طريق تحويل أو دمج مصادر بيانات أخرى. يمكن أن توجد مصادر بيانات متعددة لنوع البيانات نفسه. لكل نقطة بيانات في كل مجموعة بيانات يتم إدراجها أو قراءتها من واجهة برمجة تطبيقات اللياقة البدنية مصدر بيانات مرتبط.
ينتج كل مصدر بيانات مصدرًا فريدًا من تعديلات مجموعة البيانات، باستخدام معرّف مصدر بيانات فريد. لا تؤثر كل التغييرات التي تطرأ على مصدر البيانات في معرّف مصدر البيانات، وبالتالي فإنّ البيانات التي يتم جمعها من خلال الإصدارات المُحدَّثة من التطبيق/الجهاز نفسه من الممكن اعتبارها تابعة لمصدر البيانات نفسه.
يتم تحديد مصادر البيانات باستخدام سلسلة ينشئها الخادم، استنادًا إلى محتوى المصدر الذي يتم إنشاؤه. يجب عدم ضبط الحقلdataStreamId
عند استدعاء هذه الطريقة. فسيتم إنشاؤه تلقائيًا بواسطة الخادم بالتنسيق الصحيح. وإذا تم ضبط السمةdataStreamId
، يجب أن يتطابق هذا التنسيق مع التنسيق الذي سينشئه الخادم. هذا التنسيق عبارة عن مجموعة من بعض الحقول من مصدر البيانات، وله ترتيب محدد. وإذا لم يتطابق، فسيفشل الطلب مع وجود خطأ.
يؤدي تحديد نوع بيانات غير معروف (يبدأ بـ "com.google.") إلى إنشاء مصدر بيانات يحتوي على نوع بيانات مخصّص. لا يمكن قراءة أنواع البيانات المخصّصة إلا من خلال التطبيق الذي أنشأها. تم إيقاف أنواع البيانات المخصّصة، لذا استخدِم أنواع البيانات العادية بدلاً من ذلك.
بالإضافة إلى حقول مصدر البيانات المضمّنة في رقم تعريف مصدر البيانات، يتم تضمين رقم مشروع المطوِّر الذي تمت المصادقة عليه عند إنشاء مصدر البيانات. يتم تشويش رقم مشروع المطوّر هذا عند قراءته من قِبل أي مطوّر آخر يقرأ أنواع البيانات العامة. - حذف
- حذف مصدر البيانات المحدّد سيفشل الطلب إذا كان مصدر البيانات يحتوي على أي نقاط بيانات.
- الحصول على
- لعرض مصدر البيانات المحدّد.
- list
- تسرد قائمة بجميع مصادر البيانات المرئية للمطوّر، باستخدام نطاقات OAuth المتوفرة. القائمة ليست شاملة، وقد يكون لدى المستخدم مصادر بيانات خاصة لا تظهر إلا للمطوّرين الآخرين، أو قد يكون للمستخدم مكالمات تستخدم نطاقات أخرى.
- تعديل
- لتعديل مصدر البيانات المحدَّد. لا يمكن تعديل السمات
dataStreamId
وdataType
وtype
وdataStreamName
وdevice
باستثناءversion
.
يتم تحديد مصادر البيانات من خلالdataStreamId
.