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 مقادیر هر فیلد نوع داده برای نقطه داده. انتظار می رود که هر مقدار مربوط به یک فیلد نوع داده به همان ترتیبی رخ دهد که فیلد در نوع داده مشخص شده در منبع داده فهرست شده است.

فقط یکی از فیلدهای عدد صحیح و ممیز شناور، بسته به مقدار فرمت enum در فیلد نوع منبع داده، پر می شود.

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 )، و یک نقطه داده در هر یک از نقاط پایانی مجموعه داده قرار دارد، فقط قسمت همپوشانی نقطه داده حذف خواهد شد.
دریافت کنید
مجموعه داده ای حاوی تمام نقاط داده را برمی گرداند که زمان شروع و پایان آنها با محدوده مشخص شده حداقل زمان شروع و حداکثر زمان پایان مجموعه داده همپوشانی دارند. به طور خاص، هر نقطه داده ای که زمان شروع آن کمتر یا مساوی با زمان پایان مجموعه داده باشد و زمان پایان آن بزرگتر یا مساوی با زمان شروع مجموعه داده باشد.
پچ
نقاط داده را به یک مجموعه داده اضافه می کند. لازم نیست مجموعه داده قبلا ایجاد شده باشد. تمام نقاط در مجموعه داده داده شده با فراخوانی های بعدی برای بازیابی این مجموعه داده بازگردانده می شود. نقاط داده می توانند به بیش از یک مجموعه داده تعلق داشته باشند.

این روش از معنی‌شناسی وصله استفاده نمی‌کند: نقاط داده ارائه شده صرفاً درج می‌شوند، بدون اینکه داده‌های موجود جایگزین شوند.