Users.dataSources.datasets

تمثّل مجموعة البيانات حاوية عرض لنقاط البيانات. إنها لا تحمل أي معلومات خاصة بها. تمثّل مجموعات البيانات مجموعة من نقاط البيانات من مصدر بيانات معيّن. ويمكن العثور على نقطة بيانات في أكثر من مجموعة بيانات واحدة.

للحصول على قائمة بطرق هذا المورد، راجع نهاية هذه الصفحة.

تمثيلات موارد

{
  "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) ونقطة بيانات البيانات على أيٍّ من نقطة النهاية لمجموعة البيانات، سيتم حذف الجزء المتداخل من نقطة البيانات فقط.

الحصول

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

رمز تصحيح

تضيف نقاط البيانات إلى مجموعة بيانات. لا حاجة إلى إنشاء مجموعة البيانات في السابق. سيتم عرض جميع النقاط ضمن مجموعة البيانات المحددة مع المكالمات اللاحقة لاسترداد مجموعة البيانات هذه. يمكن أن تنتمي نقاط البيانات إلى أكثر من مجموعة بيانات واحدة.

لا تستخدِم هذه الطريقة دلالات التصحيح: يتم إدراج نقاط البيانات المُقدَّمة فقط، بدون استبدال البيانات الحالية.