שאילתות לגבי שינויים בנקודות נתונים של משתמש עבור מקור נתונים מסוים. כדאי לנסות עכשיו.
שליחת בקשה
בקשת HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges
פרמטרים
שם הפרמטר | ערך | תיאור |
---|---|---|
פרמטרים של נתיב | ||
dataSourceId |
string |
המזהה של מקור הנתונים של מקור הנתונים שיצר את מערך הנתונים. |
userId |
string |
הצגת רשימה של נקודות נתונים על האדם שזוהה. משתמשים ב-me כדי לציין
את המשתמש המאומת. רק me נתמכים בשלב זה.
|
פרמטרים אופציונליים של השאילתה | ||
limit |
integer |
אם תציינו זאת, השינויים האלה לא ייכללו במענה. |
pageToken |
string |
אסימון ההמשך, המשמש לדף בקבוצות של תוצאות גדולות.
כדי לקבל את דף התוצאות הבא, יש להגדיר את הפרמטר לערך של nextPageToken מהתגובה הקודמת.
|
הרשאה
הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:
היקף ההרשאות |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
מידע נוסף זמין בדף אימות והרשאה.
גוף הבקשה
אין לספק גוף בקשה בשיטה זו.
תשובה
אם השיטה הזו מוצלחת, היא מחזירה גוף תגובה עם המבנה הבא:
{ "insertedDataPoint": [ { "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 } ], "deletedDataPoint": [ { "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 }
שם הנכס | ערך | תיאור | הערות |
---|---|---|---|
insertedDataPoint[] |
list |
נקודות נתונים נוספו עבור המשתמש. | |
insertedDataPoint[].startTimeNanos |
long |
שעת ההתחלה של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
insertedDataPoint[].endTimeNanos |
long |
שעת הסיום של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
insertedDataPoint[].dataTypeName |
string |
סוג הנתונים המגדיר את הפורמט של הערכים בנקודה זו של נתונים. | |
insertedDataPoint[].originDataSourceId |
string |
אם נקודת הנתונים נכללת במערך נתונים של מקור נתונים נגזר, השדה הזה יאוכלס במזהה של מקור הנתונים שיצר את נקודת הנתונים במקור. אזהרה: אין להסתמך על השדה הזה לכל מידע אחר מלבד ניפוי באגים. הערך של השדה הזה, אם הוא מוגדר בכלל, הוא פרטי הטמעה ולא מובטח שהוא יהיה עקבי. |
|
insertedDataPoint[].value[] |
list |
הערכים בכל שדה של סוג נתונים בנקודת הנקודה. צפוי שכל ערך שתואם לשדה מסוג נתונים יתבצע באותו סדר שבו מופיע השדה בסוג הנתונים שצוין במקור הנתונים. רק השדה 'מספר שלם' ושדה נקודה צפה יאוכלס, בהתאם לערך הסוג של השדה 'enum' בשדה הסוג של מקור הנתונים. |
|
insertedDataPoint[].value[].intVal |
integer |
ערך מספר שלם. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. | |
insertedDataPoint[].value[].fpVal |
double |
ערך נקודה צפה. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. | |
insertedDataPoint[].value[].stringVal |
string |
ערך מחרוזת. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. כדאי שהמחרוזות יהיו קטנות ככל האפשר. מקורות נתונים עם ערכי מחרוזת גדולים ותדירות נתונים גבוהה עשויים להידגם. | |
insertedDataPoint[].value[].mapVal[] |
list |
ערך מפה. יש לתעד את המרחב המשותף והיחידות החוקיות של הערך התואם של כל רשומה כחלק מהגדרת סוג הנתונים. כדאי לשמור על מפתחות קטנים ככל האפשר. ייתכן שהמערכת תדגום מקורות נתונים עם מפתחות גדולים ותדירות נתונים גבוהה. | |
insertedDataPoint[].value[].mapVal[].key |
string |
||
insertedDataPoint[].value[].mapVal[].value |
nested object |
||
insertedDataPoint[].value[].mapVal[].value.fpVal |
double |
ערך נקודה צפה. | |
insertedDataPoint[].modifiedTimeMillis |
long |
מציין את הפעם האחרונה שבה נקודה זו שונתה. האפשרות הזו שימושית רק בהקשרים שבהם אנחנו מציגים את השינויים בנתונים, במקום לייצג את המצב הנוכחי של הנתונים. | |
insertedDataPoint[].rawTimestampNanos |
long |
חותמת הזמן הגולמית מה-SensorEvent המקורי. | |
insertedDataPoint[].computationTimeMillis |
long |
אין להשתמש בשדה הזה. המערכת מתעלמת ממנה ולא שומרת. | |
deletedDataPoint[] |
list |
נקודות נתונים שנמחקו עבור המשתמש. הערה: כדי לבצע שינויים צריך לנתח את הנתונים לפני שמתחילים להשתמש בהם. | |
deletedDataPoint[].startTimeNanos |
long |
שעת ההתחלה של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
deletedDataPoint[].endTimeNanos |
long |
שעת הסיום של המרווח המיוצג על ידי נקודת הנתונים הזו, באלפיות שנייה מאז התקופה. | |
deletedDataPoint[].dataTypeName |
string |
סוג הנתונים המגדיר את הפורמט של הערכים בנקודה זו של נתונים. | |
deletedDataPoint[].originDataSourceId |
string |
אם נקודת הנתונים נכללת במערך נתונים של מקור נתונים נגזר, השדה הזה יאוכלס במזהה של מקור הנתונים שיצר את נקודת הנתונים במקור. אזהרה: אין להסתמך על השדה הזה לכל מידע אחר מלבד ניפוי באגים. הערך של השדה הזה, אם הוא מוגדר בכלל, הוא פרטי הטמעה ולא מובטח שהוא יהיה עקבי. |
|
deletedDataPoint[].value[] |
list |
הערכים בכל שדה של סוג נתונים בנקודת הנקודה. צפוי שכל ערך שתואם לשדה מסוג נתונים יתבצע באותו סדר שבו מופיע השדה בסוג הנתונים שצוין במקור הנתונים. רק השדה 'מספר שלם' ושדה נקודה צפה יאוכלס, בהתאם לערך הסוג של השדה 'enum' בשדה הסוג של מקור הנתונים. |
|
deletedDataPoint[].value[].intVal |
integer |
ערך מספר שלם. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. | |
deletedDataPoint[].value[].fpVal |
double |
ערך נקודה צפה. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. | |
deletedDataPoint[].value[].stringVal |
string |
ערך מחרוזת. כאשר היא מוגדרת, אין להגדיר ערכים אחרים. כדאי שהמחרוזות יהיו קטנות ככל האפשר. מקורות נתונים עם ערכי מחרוזת גדולים ותדירות נתונים גבוהה עשויים להידגם. | |
deletedDataPoint[].value[].mapVal[] |
list |
ערך מפה. יש לתעד את המרחב המשותף והיחידות החוקיות של הערך התואם של כל רשומה כחלק מהגדרת סוג הנתונים. כדאי לשמור על מפתחות קטנים ככל האפשר. ייתכן שהמערכת תדגום מקורות נתונים עם מפתחות גדולים ותדירות נתונים גבוהה. | |
deletedDataPoint[].value[].mapVal[].key |
string |
||
deletedDataPoint[].value[].mapVal[].value |
nested object |
||
deletedDataPoint[].value[].mapVal[].value.fpVal |
double |
ערך נקודה צפה. | |
deletedDataPoint[].modifiedTimeMillis |
long |
מציין את הפעם האחרונה שבה נקודה זו שונתה. האפשרות הזו שימושית רק בהקשרים שבהם אנחנו מציגים את השינויים בנתונים, במקום לייצג את המצב הנוכחי של הנתונים. | |
deletedDataPoint[].rawTimestampNanos |
long |
חותמת הזמן הגולמית מה-SensorEvent המקורי. | |
deletedDataPoint[].computationTimeMillis |
long |
אין להשתמש בשדה הזה. המערכת מתעלמת ממנה ולא שומרת. | |
nextPageToken |
string |
אסימון ההמשך, המשמש לדף בקבוצות של תוצאות גדולות. יש לספק את הערך הזה בבקשה חוזרת כדי להחזיר את דף התוצאות הבא. | |
dataSourceId |
string |
המזהה של מקור הנתונים שמקור הנתונים שלו השתנה. |
רוצה לנסות?
כדי לקרוא לשיטה הזו על נתונים בזמן אמת ולראות את התגובה, אתם צריכים להשתמש ב-APIs Explorer.