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