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

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

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

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

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

שיטת HTTP
POST
בקש כתובת אתר
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
GET
בקש כתובת אתר
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
POST
בקש כתובת אתר
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"