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

הורדה

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

תיקון

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

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