ניהול מקורות נתונים

בעזרת ה-API ל-REST של Fitness אפשר ליצור, לקבל ולעדכן מקורות נתונים. מקור נתונים מייצג מקור ייחודי לנתוני חיישנים. אתם משתמשים במקורות נתונים כדי להכניס נתוני כושר, אחסון, ואפשר לאחזר נתוני כושר שנוספו על ידי מקור נתונים מסוים.

מקורות נתונים מיוצגים על ידי Users.dataSources משאב.

יצירת מקור נתונים

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

שיטת HTTP
פרסום
בקש כתובת אתר
https://www.googleapis.com/fitness/v1/users/me/dataSources
גוף הבקשה
{
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "1.0"
  }
}
תשובה

אם מקור הנתונים נוצר בהצלחה, התגובה תהיה בסטטוס 200 OK גוף התשובה מכיל ייצוג JSON של מקור הנתונים, כולל datasource.dataStreamId שבו תוכלו להשתמש כמזהה של מקור הנתונים לבקשות הבאות.

פקודת Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @createds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources"

אחזור של מקור נתונים ספציפי

הדוגמה הזו ממחישה איך לאחזר את מקור הנתונים ("MyDataSource") שיצרתם בדוגמה הקודמת. כשיוצרים מקור נתונים חדש, dataStreamId כולל מזהה ייחודי (מוצג כ-"1234567890" לדוגמה). זהו מספר פרויקט המפתח שלך, והוא יהיה זהה עבור את כל הבקשות שנשלחו באמצעות חשבון הפיתוח המסוים. חשוב להשתמש dataStreamId ממקור הנתונים שיצרת.

שיטת HTTP
הורדה
בקש כתובת אתר
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
גוף הבקשה
ללא
תשובה
אם מקור הנתונים קיים, התגובה היא קוד הסטטוס 200 OK. גוף התשובה מכיל ייצוג JSON של מקור הנתונים.
פקודת Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X GET 

--header "Content-Type: application/json;encoding=utf-8" 

"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

קבלת נתונים נצברים

הדוגמה הזו ממחישה איך לשלוח שאילתות על מקור נתונים ספציפי לגבי נתונים נצברים נתונים, במקרה הזה estimated_steps, שהוא מקור הנתונים שמשמש להצגת במספר הצעדים באפליקציית Google Fit. שימו לב שחותמות זמן בבקשת JSON נמצאים באלפיות שנייה.

שיטת HTTP
פרסום
בקש כתובת אתר
https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate
גוף הבקשה
{
  "aggregateBy": [{
    "dataSourceId":
      "derived:com.google.step_count.delta:com.google.android.gms:estimated_steps"
  }],
  "bucketByTime": { "durationMillis": 86400000 },
  "startTimeMillis": 1454284800000,
  "endTimeMillis": 1455062400000
}
תשובה

אם מקורות הנתונים קיימים, התגובה היא קוד הסטטוס 200 OK. גוף התשובה מכיל ייצוג JSON של מקור הנתונים.

פקודת Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X POST \
--header "Content-Type: application/json;encoding=utf-8" -d @aggregate.json \
"https://www.googleapis.com/fitness/v1/users/me/dataset:aggregate"

עדכון מקור נתונים

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

שיטת HTTP
PUT
בקש כתובת אתר
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
גוף הבקשה
{
  "dataStreamId": "derived:com.google.step_count.delta:1234567890:Example Manufacturer:ExampleTablet:1000001:MyDataSource",
  "dataStreamName": "MyDataSource",
  "type": "derived",
  "application": {
    "detailsUrl": "http://example.com",
    "name": "Foo Example App",
    "version": "1"
  },
  "dataType": {
    "field": [
      {
        "name": "steps",
        "format": "integer"
      }
    ],
    "name": "com.google.step_count.delta"
  },
  "device": {
    "manufacturer": "Example Manufacturer",
    "model": "ExampleTablet",
    "type": "tablet",
    "uid": "1000001",
    "version": "2.0"
  }
}
תשובה

אם מקור הנתונים עודכן בהצלחה, התגובה תהיה בסטטוס 200 OK גוף התשובה מכיל ייצוג JSON של מקור הנתונים.

פקודת Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X PUT \
--header "Content-Type: application/json;encoding=utf-8" -d @updateds.json \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"

מחיקת מקור נתונים

הדוגמה הזו ממחישה איך למחוק מקור נתונים.

שיטת HTTP
מחיקה
בקש כתובת אתר
https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource
גוף הבקשה
ללא
תשובה
אם מקור הנתונים יימחק בהצלחה, סטטוס התגובה יהיה 200 OK גוף התשובה מכיל ייצוג JSON של מקור הנתונים נמחק.
פקודת Curl
$ curl --header "Authorization: Bearer ya29.yourtokenvalue" -X DELETE \
--header "Content-Type: application/json;encoding=utf-8" \
"https://www.googleapis.com/fitness/v1/users/me/dataSources/derived:com.google.step_count.delta:1234567890:Example%20Manufacturer:ExampleTablet:1000001:MyDataSource"