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

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