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

الحصول على

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

التصحيح

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

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