تمثل مجموعة البيانات حاوية إسقاط لنقاط البيانات. وهي لا تملك أي معلومات خاصة بها. تمثل مجموعات البيانات مجموعة من نقاط البيانات من مصدر بيانات معين. يمكن العثور على نقطة بيانات في أكثر من مجموعة بيانات واحدة.
للحصول على قائمة من الطرق لهذا المورد، راجِع نهاية هذه الصفحة.
تمثيلات الموارد
{
"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
}| اسم الموقع | القيمة | الوصف | ملاحظات |
|---|---|---|---|
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) وتداخل نقطة بيانات أي نقطة نهاية من مجموعة البيانات، فقط الجزء المتداخل من البيانات سيتم حذف هذه النقطة. - الحصول على
- عرض مجموعة بيانات تحتوي على جميع نقاط البيانات التي يكون وقت بدئها وانتهائها مع النطاق المحدد من الحد الأدنى لوقت بدء مجموعة البيانات الحد الأقصى لوقت الانتهاء. وعلى وجه التحديد، أي نقطة بيانات يكون وقت بدئها أقل من ذلك من أو يساوي وقت انتهاء مجموعة البيانات ويكون وقت انتهائها أكبر من مساويًا لوقت بدء مجموعة البيانات.
- التصحيح
- لإضافة نقاط بيانات إلى مجموعة بيانات. لا يلزم إنشاء مجموعة البيانات مسبقًا.
سيتم عرض جميع النقاط ضمن مجموعة البيانات المحدّدة باستدعاءات تالية
لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة.
لا تستخدم هذه الطريقة دلالات التصحيح: نقاط البيانات المقدمة هي فقط، مع عدم استبدال البيانات الموجودة.