Users.dataSources.dataPointChanges: list

הערה: נדרשת הרשאה.

שאילתות לגבי נקודת הנתונים של המשתמש משתנות עבור מקור נתונים ספציפי. רוצים לנסות עכשיו?

בקשה

בקשת 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	הערכים של כל שדה בסוג הנתונים של הנקודה על הגרף. מצופה שכל ערך שתואם לשדה של סוג הנתונים יופיע באותו סדר שבו השדה מופיע בסוג הנתונים שצוין במקור הנתונים. רק אחד מהשדות של מספרים שלמים ונקודה צפה (floating-point) יאוכלס, בהתאם לפורמט enum שבשדה הסוג של מקור הנתונים.
insertedDataPoint[].value[].intVal	integer	ערך של מספר שלם. כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים.
insertedDataPoint[].value[].fpVal	double	ערך נקודה צפה (floating-point). כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים.
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	ערך נקודה צפה (floating-point).
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	הערכים של כל שדה בסוג הנתונים של הנקודה על הגרף. מצופה שכל ערך שתואם לשדה של סוג הנתונים יופיע באותו סדר שבו השדה מופיע בסוג הנתונים שצוין במקור הנתונים. רק אחד מהשדות של מספרים שלמים ונקודה צפה (floating-point) יאוכלס, בהתאם לפורמט enum שבשדה הסוג של מקור הנתונים.
deletedDataPoint[].value[].intVal	integer	ערך של מספר שלם. כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים.
deletedDataPoint[].value[].fpVal	double	ערך נקודה צפה (floating-point). כשהערך מוגדר, אי אפשר להגדיר ערכים אחרים.
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	ערך נקודה צפה (floating-point).
deletedDataPoint[].modifiedTimeMillis	long	מציין את הפעם האחרונה שבה בוצע שינוי בנקודת הנתונים הזו. שימושי רק בהקשרים שבהם אנחנו מפרטים את השינויים בנתונים, במקום לייצג את המצב הנוכחי של הנתונים.
deletedDataPoint[].rawTimestampNanos	long	חותמת הזמן הגולמית מאירוע SensorEvent המקורי.
deletedDataPoint[].computationTimeMillis	long	אין להשתמש בשדה הזה. המערכת מתעלמת ממנו ולא נשמר.
nextPageToken	string	אסימון ההמשך, המשמש לדפדוף בין קבוצות גדולות של תוצאות. צריך לציין את הערך הזה בבקשה לאחר מכן כדי לקבל את דף התוצאות הבא.
dataSourceId	string	מזהה מקור הנתונים של מקור הנתונים, עם שינויים בנקודת הנתונים.

נסה בעצמך!

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