การจัดการแหล่งข้อมูล

Fitness REST API ช่วยให้คุณสร้าง รับ และอัปเดตแหล่งข้อมูลได้ แหล่งข้อมูลแสดงถึง ซึ่งเป็นแหล่งข้อมูลเฉพาะของเซ็นเซอร์ คุณใช้แหล่งข้อมูลเพื่อแทรกข้อมูลการออกกำลังกายในฟิตเนส ของคุณ และคุณสามารถเรียกข้อมูลการออกกำลังกายที่แทรกโดยแหล่งข้อมูลหนึ่งๆ ได้

แหล่งข้อมูลจะแสดงด้วยUsers.dataSources ทรัพยากร

สำคัญ: โปรดดูแนวทางปฏิบัติแนะนำเมื่อจัดการข้อมูลผู้ใช้ที่หัวข้อ การใช้ Google Fit อย่างมีความรับผิดชอบ

สร้างแหล่งข้อมูล

ตัวอย่างนี้แสดงวิธีสร้างแหล่งข้อมูลใหม่ชื่อ "MyDataSource" ที่แสดงการเพิ่มขึ้นของจำนวนก้าว

เมธอด HTTP

โพสต์

URL คำขอ

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

รับ

URL คำขอ

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

โพสต์

URL คำขอ

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

วาง

URL คำขอ

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

ลบ

URL คำขอ

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"