מחברת נקודות על הגרף למערך נתונים. אין צורך ליצור את מערך הנתונים לפני כן.
כל הנקודות במערך הנתונים הזה יוחזרו עם הקריאות הבאות כדי לאחזר את מערך הנתונים. נקודות על הגרף יכולות להשתייך ליותר ממערך נתונים אחד.
בשיטה הזו לא משתמשים בסמנטיקה של תיקונים: הנקודות על הגרף רק מוכנסות, ולא מתבצעת החלפה של הנתונים הקיימים.
רוצים לנסות עכשיו?
בקשה
בקשת HTTP
PATCH https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/datasets/datasetId
פרמטרים
| שם הפרמטר | ערך | תיאור |
|---|---|---|
| פרמטרים של נתיב | ||
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את מערך הנתונים. |
datasetId |
string |
השדה הזה לא בשימוש וניתן להשמיט אותו באופן בטוח. |
userId |
string |
תיקון מערך נתונים עבור האדם שזוהה. השתמשו ב-me כדי לציין את המשתמש המאומת. יש כרגע תמיכה רק ב-me.
|
אישור
בקשה זו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:
| היקף |
|---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
למידע נוסף, עיין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מספקים את החלקים הרלוונטיים של משאב Users.dataSources.datasets, בהתאם לכללי סמנטיקה של תיקון, עם המאפיינים הבאים:
| שם הנכס | ערך | תיאור | הערות |
|---|---|---|---|
| המאפיינים הנדרשים | |||
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את הנקודות במערך הנתונים. | |
maxEndTimeNs |
long |
שעת הסיום הגדולה ביותר של כל נקודות הנתונים בייצוג החלקי הזה של מערך הנתונים. הזמן נמצא בננו-שניות מתקופה של זמן מערכת. הוא צריך להתאים גם לחלק השני של מזהה מערך הנתונים. | |
minStartTimeNs |
long |
שעת ההתחלה הקטנה ביותר של כל הנקודות על הגרף בייצוג החלקי הזה של מערך הנתונים. הזמן נמצא בננו-שניות מתקופה של זמן מערכת. הוא צריך להתאים גם לחלק הראשון של מזהה מערך הנתונים. | |
point[] |
list |
רשימה חלקית של נקודות נתונים שכלולות במערך הנתונים, מסודרים לפי endTimeNanos. הרשימה הזו נחשבת כרשימה מלאה באחזור מערך נתונים קטן, ובנתונים חלקיים כשתיקון מערך נתונים או מאחזרים מערך נתונים גדול מדי מכדי לכלול אותו בתגובה יחידה. | |
point[].dataTypeName |
string |
סוג הנתונים שמגדיר את הפורמט של הערכים בנקודה על הגרף. | |
point[].endTimeNanos |
long |
שעת הסיום של מרווח הזמן שמיוצג על ידי הנקודה על הגרף, בננו-שניות מאז תחילת התקופה. | |
point[].startTimeNanos |
long |
שעת ההתחלה של מרווח הזמן שמיוצג על ידי נקודת הנתונים הזו, בננו-שניות מאז תחילת התקופה. | |
point[].value[] |
list |
הערכים של כל שדה סוג נתונים עבור הנקודה על הגרף. סביר להניח שכל ערך שתואם לשדה של סוג נתונים מסוים יופיע באותו סדר שבו מופיע השדה לפי סוג הנתונים שצוין במקור נתונים. רק אחד מהשדות 'מספרים שלמים' ו'נקודה צפה' יאוכלס, בהתאם לערך 'טיפוסים בני מנייה (enum)' בשדה הסוג של מקור הנתונים. |
|
תשובה
אם הפעולה בוצעה בהצלחה, השיטה הזו מחזירה משאב Users.dataSources.datasets בגוף התשובה.
רוצה לנסות?
צריך להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.