דף זה תורגם על ידי Cloud Translation API.

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

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

מקורות נתונים מיוצגים על ידי המשאב 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

פוט

בקש כתובת אתר

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"