Users.dataSources.datasets: patch

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

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

בקשה

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

רק אחד מהשדות של מספרים שלמים ונקודה צפה (floating-point) יאוכלס, בהתאם לפורמט enum שבשדה הסוג של מקור הנתונים.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Users.dataSources.datasets בגוף התגובה.

נסה בעצמך!

אפשר להשתמש ב-APIs Explorer שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.