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) ונקודות נקודה על הגרף של כל אחת מנקודות הקצה יימחק, רק החלק החופף של נקודת הנתונים יימחק.

הורדה

מחזירה מערך נתונים שמכיל את כל נקודות הנתונים שזמני ההתחלה והסיום שלהן חופפים לטווח שצוין של זמן ההתחלה המינימלי של מערך הנתונים ושעת הסיום המקסימלית. באופן ספציפי, כל נקודת נתונים ששעת ההתחלה שלה נמוכה משעת הסיום של מערך הנתונים או שווה לה, ושעת הסיום שלה גדולה משעת ההתחלה של מערך הנתונים או שווה לו.

תיקון

הוספת נקודות נתונים למערך נתונים. אין צורך ליצור את מערך הנתונים בעבר. כל הנקודות במערך הנתונים הזה יוחזרו עם קריאות עוקבות כדי לאחזר את מערך הנתונים. נקודות נתונים יכולות להשתייך ליותר ממערך נתונים אחד.

בשיטה הזו לא משתמשים בסמנטיקה של תיקון: הנקודות על הגרף פשוט מתווספות רק ללא שינוי בנתונים הקיימים.