הוספת נקודות נתונים למערך נתונים. אין צורך ליצור את מערך הנתונים בעבר.
כל הנקודות במערך הנתונים הזה יוחזרו עם קריאות עוקבות כדי לאחזר את מערך הנתונים. נקודות נתונים יכולות להשתייך ליותר ממערך נתונים אחד.
בשיטה הזו לא משתמשים בסמנטיקה של תיקון: הנקודות על הגרף פשוט מתווספות רק ללא שינוי בנתונים הקיימים.
כדאי לנסות עכשיו.
שליחת בקשה
בקשת 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 |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
בגוף הבקשה, מספקים את החלקים הרלוונטיים של משאב User.dataSources.datasets, בהתאם לכללי הסמנטיקה של התיקון, עם המאפיינים הבאים:
| שם הנכס | ערך | תיאור | הערות |
|---|---|---|---|
| מאפיינים נדרשים | |||
dataSourceId |
string |
מזהה מקור הנתונים של מקור הנתונים שיצר את הנקודות במערך הנתונים הזה. | |
maxEndTimeNs |
long |
שעת הסיום הגדולה ביותר לכל נקודות הנתונים בייצוג החלקי הזה של מערך הנתונים. הזמן הוא באלפיות שנייה מתחילת התקופה. הערך הזה צריך להתאים גם לחלק השני של מזהה מערך הנתונים. | |
minStartTimeNs |
long |
זמן ההתחלה הקצר ביותר של כל נקודות הנתונים בייצוג החלקי הזה של מערך הנתונים. הזמן הוא באלפיות שנייה מתחילת התקופה. הערך הזה צריך להיות זהה גם לחלק הראשון של מזהה מערך הנתונים. | |
point[] |
list |
רשימה חלקית של נקודות נתונים הכלולות במערך הנתונים, מסודרות לפי endTimeNanos. הרשימה הזו נחשבת שלמה בעת אחזור של מערך נתונים קטן וחלקי בעת תיקון מערך נתונים או אחזור של מערך נתונים גדול מדי מכדי לכלול אותו בתגובה אחת. | |
point[].dataTypeName |
string |
סוג הנתונים המגדיר את הפורמט של הערכים בנקודה זו של נתונים. | |
point[].endTimeNanos |
long |
שעת הסיום של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
point[].startTimeNanos |
long |
שעת ההתחלה של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
point[].value[] |
list |
הערכים בכל שדה של סוג נתונים בנקודת הנקודה. צפוי שכל ערך שתואם לשדה מסוג נתונים יתבצע באותו סדר שבו מופיע השדה בסוג הנתונים שצוין במקור הנתונים. רק השדה 'מספר שלם' ושדה נקודה צפה יאוכלס, בהתאם לערך הסוג של השדה 'enum' בשדה הסוג של מקור הנתונים. |
|
תשובה
אם היא מוצלחת, השיטה הזו מחזירה משאב User.dataSources.datasets בגוף התגובה.
רוצה לנסות?
כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, אתם צריכים להשתמש ב-APIs Explorer.