تمثّل مجموعة البيانات حاوية إسقاط لنقاط البيانات. كما أنّها لا تحمل أي معلومات خاصة بها. تمثل مجموعات البيانات مجموعة من نقاط البيانات من مصدر بيانات معين. يمكن العثور على نقطة البيانات في أكثر من مجموعة بيانات واحدة.
للحصول على قائمة بالطرق لهذا المورد، اطّلِع على نهاية هذه الصفحة.
تمثيلات الموارد
{ "minStartTimeNs": long, "maxEndTimeNs": long, "dataSourceId": string, "point": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string }
اسم الموقع | القيمة | الوصف | Notes |
---|---|---|---|
dataSourceId |
string |
رقم تعريف مصدر البيانات لمصدر البيانات الذي أنشأ النقاط في مجموعة البيانات هذه. | |
maxEndTimeNs |
long |
أكبر وقت انتهاء لجميع نقاط البيانات في هذا التمثيل الجزئي الذي ربما يتم تمثيله لمجموعة البيانات. الوقت بالنانوثانية من الفترة. يجب أن يتطابق هذا أيضًا مع الجزء الثاني من معرّف مجموعة البيانات. | |
minStartTimeNs |
long |
أصغر وقت بدء لجميع نقاط البيانات في هذا التمثيل الجزئي المحتمل لمجموعة البيانات. الوقت بالنانوثانية من الفترة. ويجب أن يتطابق هذا أيضًا مع الجزء الأول من معرّف مجموعة البيانات. | |
nextPageToken |
string |
سيتم تعيين هذا الرمز المميز عندما يتم تلقي مجموعة بيانات استجابةً لطلب GET وتكون مجموعة البيانات كبيرة جدًا بحيث لا يمكن تضمينها في استجابة واحدة. قدم هذه القيمة في طلب GET لاحق لإرجاع الصفحة التالية لنقاط البيانات ضمن مجموعة البيانات هذه. | |
point[] |
list |
قائمة جزئية بنقاط البيانات المضمنة في مجموعة البيانات، مرتبة حسب endTimeNanos. تعتبر هذه القائمة كاملة عند استرداد مجموعة بيانات صغيرة وجزئية عند تصحيح مجموعة بيانات أو استرداد مجموعة بيانات كبيرة جدًا بحيث لا يمكن تضمينها في إجابة واحدة. | |
point[].computationTimeMillis |
long |
لا تستخدِم هذا الحقل. ويتم تجاهلها ولا يتم تخزينها. | |
point[].dataTypeName |
string |
تمثّل هذه السمة نوع البيانات الذي يحدّد تنسيق القيم في نقطة البيانات هذه. | |
point[].endTimeNanos |
long |
وقت انتهاء الفاصل الزمني الذي تمثله نقطة البيانات هذه، بالنانو ثانية منذ تاريخ بدء حساب الفترة. | |
point[].modifiedTimeMillis |
long |
يشير إلى آخر مرة تم فيها تعديل نقطة البيانات هذه. مفيد فقط في السياقات التي ندرج فيها تغييرات البيانات، بدلاً من تمثيل الحالة الحالية للبيانات. | |
point[].originDataSourceId |
string |
إذا كانت نقطة البيانات مضمّنة في مجموعة بيانات لمصدر بيانات مشتق، ستتم تعبئة هذا الحقل برقم تعريف مصدر البيانات الذي تم من خلاله إنشاء نقطة البيانات في الأصل. تحذير: لا تعتمد على هذا الحقل في أي إجراء بخلاف تصحيح الأخطاء. تُعدّ قيمة هذا الحقل، في حال ضبطها على الإطلاق، تفاصيل تنفيذ ولا يمكن ضمان بقاءها متسقة. |
|
point[].rawTimestampNanos |
long |
الطابع الزمني الأولي من حدث SensorEvent الأصلي. | |
point[].startTimeNanos |
long |
وقت بدء الفاصل الزمني الذي تمثّله نقطة البيانات هذه، بالنانو ثانية منذ تاريخ بدء حساب الفترة. | |
point[].value[] |
list |
قيم كل حقل من حقول نوع البيانات لنقطة البيانات. من المتوقّع أن تحدث كل قيمة تتوافق مع حقل نوع البيانات بالترتيب نفسه الذي تم إدراجه في الحقل في نوع البيانات المحدّد في مصدر البيانات. لن تتم تعبئة سوى حقل واحد من حقول العدد الصحيح والنقاط العائمة، بناءً على قيمة تعداد التنسيق في حقل نوع مصدر البيانات. |
|
point[].value[].fpVal |
double |
تمثّل هذه السمة قيمة النقطة العائمة. وعند ضبطها، يجب عدم ضبط قيم أخرى. | |
point[].value[].intVal |
integer |
قيمة عدد صحيح. وعند ضبطها، يجب عدم ضبط قيم أخرى. | |
point[].value[].mapVal[] |
list |
تحديد قيمة الخريطة يجب توثيق مساحة المفتاح والوحدات الصالحة للقيمة المقابلة لكل إدخال كجزء من تعريف نوع البيانات. يجب الحفاظ على صغر حجم المفاتيح كلما أمكن ذلك. قد يتمّ تقليل عيّنات من مصادر البيانات التي تتضمّن مفاتيح كبيرة ومعدّل تكرار مرتفع للبيانات. | |
point[].value[].mapVal[].key |
string |
||
point[].value[].mapVal[].value |
nested object |
||
point[].value[].mapVal[].value.fpVal |
double |
تمثّل هذه السمة قيمة النقطة العائمة. | |
point[].value[].stringVal |
string |
قيمة السلسلة. وعند ضبطها، يجب عدم ضبط قيم أخرى. يجب الحفاظ على السلاسل صغيرة كلما أمكن ذلك. قد يتمّ تقليل عيّنات من مصادر البيانات التي تتضمّن قيم سلسلة كبيرة ومعدّل تكرار مرتفع للبيانات. |
الطُرق
- حذف
- يجري حذف شامل لجميع نقاط البيانات التي يتداخل وقتا البدء والانتهاء
مع النطاق الزمني المحدد في رقم تعريف مجموعة البيانات. بالنسبة لمعظم أنواع البيانات،
سيتم حذف نقطة البيانات بالكامل. بالنسبة إلى أنواع البيانات التي يمثّل فيها النطاق الزمني قيمة متسقة (مثل
com.google.activity.segment
)، وتقع نقطة البيانات على فاصل بين نقطة نهاية مجموعة البيانات، سيتم حذف الجزء المتداخل من نقطة البيانات فقط. - الحصول على
- عرض مجموعة بيانات تشتمل على جميع نقاط البيانات التي يتداخل وقتا البدء والانتهاء مع النطاق المحدد للحد الأدنى لوقت بدء مجموعة البيانات والحد الأقصى لوقت الانتهاء. على وجه التحديد، أي نقطة بيانات يكون وقت بدئها أقل من أو يساوي وقت انتهاء مجموعة البيانات ويكون وقت انتهائها أكبر من أو يساوي وقت بدء مجموعة البيانات.
- تصحيح
- تضيف نقاط البيانات إلى مجموعة بيانات. لا يلزم إنشاء مجموعة البيانات مسبقًا.
سيتم إرجاع جميع النقاط ضمن مجموعة البيانات المحددة مع استدعاءات لاحقة لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة.
لا تستخدِم هذه الطريقة دلالات التصحيح: فنقاط البيانات المقدَّمة يتم إدراجها فقط، بدون استبدال أي بيانات حالية.