Users.dataSources.datasets

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

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

{
  "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 הערכים של כל שדה בסוג הנתונים של הנקודה על הגרף. מצופה שכל ערך שתואם לשדה של סוג הנתונים יופיע באותו סדר שבו השדה מופיע בסוג הנתונים שצוין במקור הנתונים.

רק אחד מהשדות של מספרים שלמים ונקודה צפה (floating-point) יאוכלס, בהתאם לפורמט enum שבשדה הסוג של מקור הנתונים.

point[].value[].fpVal double ערך נקודה צפה (floating-point). כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים.
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 ערך נקודה צפה (floating-point).
point[].value[].stringVal string ערך מחרוזת. כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים. רצוי שהמחרוזות יהיו קטנות ככל האפשר. ייתכן שתתבצע דגימה של מקורות נתונים עם ערכי מחרוזת גדולים ותדירות נתונים גבוהה.

שיטות

מחיקה
מוחקת את כל נקודות הנתונים שזמני ההתחלה והסיום שלהן כוללים. להיות חופפים לטווח הזמן שצוין במזהה מערך הנתונים. לרוב סוגי הנתונים האלה, כל נקודת הנתונים תימחק. עבור סוגי נתונים שבהם התחילית מייצג ערך עקבי (למשל com.google.activity.segment), ונקודה על הגרף בכל אחת מנקודות הקצה של מערך הנתונים, רק החלק החופף של הנתונים יימחק.
הורדה
מחזירה מערך נתונים שמכיל את כל נקודות הנתונים שמועדי ההתחלה והסיום שלהן חופפת לטווח שצוין של זמן ההתחלה המינימלי של מערך הנתונים זמן סיום מקסימלי. באופן ספציפי, כל נקודה על הגרף ששעת ההתחלה שלה קצרה יותר משעת הסיום של מערך הנתונים או שווה לה, ששעת הסיום שלה גדולה מ- או שווה לשעת ההתחלה של מערך הנתונים.
תיקון
מוסיף נקודות נתונים למערך נתונים. אין צורך ליצור את מערך הנתונים קודם. כל הנקודות במערך הנתונים הנתונים יוחזרו עם הקריאות הבאות כדי לאחזר את מערך הנתונים הזה. נקודות נתונים יכולות להשתייך ליותר ממערך נתונים אחד.

השיטה הזו לא משתמשת בסמנטיקה של תיקונים: נקודות הנתונים שסופקו רק הוכנסו, ולא הוחלפו נתונים קיימים.