แอปบันทึกข้อมูลน้ําตาลกลูโคสในเลือดโดยเขียนลงในประเภทข้อมูล com.google.blood_glucose
ในข้อมูลประเภทนี้ จุดข้อมูลแต่ละจุดจะแสดงการอ่านระดับน้ําตาลกลูโคสในเลือดเพียงครั้งเดียวทันที จุดข้อมูลประกอบด้วยช่องที่วัดระดับน้ําตาลกลูโคสในเลือด ความสัมพันธ์ชั่วคราวกับอาหารและการนอนหลับ รวมถึงแหล่งที่มาของตัวอย่างที่ถูกวัด ช่องทั้งหมดยกเว้นระดับน้ําตาลกลูโคสในเลือดเป็นส่วนที่ไม่บังคับ
- ความเข้มข้นของกลูโคสในเลือดจะวัดเป็น มิลลิโมล/ลิตร (1 มิลลิโมล/ลิตร จะเทียบเท่ากับ 18 มก./dL)
- หากระบุ ความสัมพันธ์ชั่วคราวกับอาหารต้องมีค่าใดค่าหนึ่งใน
FIELD_TEMPORAL_RELATION_TO_MEAL
- ประเภทอาหารต้องระบุค่าใดค่าหนึ่งใน
FIELD_MEAL_TYPE
หากไม่ทราบประเภทอาหาร ให้ใช้MEAL_TYPE_UNKNOWN
- หากระบุ ความสัมพันธ์ชั่วคราวกับการนอนหลับต้องมีค่าใดค่าหนึ่งใน
FIELD_TEMPORAL_RELATION_TO_SLEEP
- หากระบุไว้ แหล่งที่มาของตัวอย่างน้ําตาลกลูโคสในเลือดต้องมีค่าใดค่าหนึ่งใน
FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE
สร้างแหล่งข้อมูล
Android
หากต้องการเขียนจุดข้อมูลน้ําตาลกลูโคสในเลือด ให้สร้าง DataSource
ใหม่เป็น TYPE_BLOOD_GLUCOSE
ดังที่แสดงในตัวอย่างต่อไปนี้
val bloodGlucoseSource = DataSource.Builder()
.setDataType(TYPE_BLOOD_GLUCOSE)
// ...
.build()
REST
หากต้องการเขียนจุดข้อมูลน้ําตาลกลูโคสในเลือด ให้สร้างแหล่งข้อมูลใหม่
เมธอด HTTP
POST
URL คําขอ
https://www.googleapis.com/fitness/v1/users/me/dataSources
เนื้อความของคำขอ
{
"dataStreamName": "BloodGlucose",
"type": "raw",
"application": {
"detailsUrl": "http://example.com",
"name": "My Example App",
"version": "1"
},
"dataType": {
"name": "com.google.blood_glucose"
}
}
คําตอบ
หากสร้างแหล่งข้อมูลเรียบร้อยแล้ว การตอบกลับจะเป็นรหัสสถานะ 200 OK
เนื้อหาการตอบกลับจะมีการนําเสนอ JSON ของแหล่งข้อมูล รวมถึงพร็อพเพอร์ตี้ datasource.dataStreamId
ที่คุณจะใช้เป็นรหัสแหล่งข้อมูลสําหรับคําขอที่ตามมาได้
คําสั่ง CURL
$ curl --header "Authorization: Bearer ya29.yourtokenvalue --request POST \ --header "Content-Type: application/json;encoding=utf-8" --data @blood-glucose-ds.json \ https://www.googleapis.com/fitness/v1/users/me/dataSources
การเพิ่มข้อมูล
Android
หากต้องการเพิ่มข้อมูลไปยังแหล่งข้อมูลที่สร้างขึ้นด้านบน ให้สร้างจุดข้อมูลสําหรับแหล่งข้อมูลนี้ ซึ่งสามารถแทรกโดยใช้ History API ได้ ดังนี้
val bloodGlucose = DataPoint.builder(bloodGlucoseSource)
.setTimestamp(timestamp, TimeUnit.MILLISECONDS)
.setField(FIELD_BLOOD_GLUCOSE_LEVEL, 5.0f) // 90 mg/dL
.setField(FIELD_TEMPORAL_RELATION_TO_MEAL, FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL)
.setField(FIELD_MEAL_TYPE, MEAL_TYPE_BREAKFAST)
.setField(FIELD_TEMPORAL_RELATION_TO_SLEEP, TEMPORAL_RELATION_TO_SLEEP_ON_WAKING)
.setField(FIELD_BLOOD_GLUCOSE_SPECIMEN_SOURCE, BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD)
.build()
REST
ตัวอย่างนี้สาธิตการเพิ่มข้อมูลน้ําตาลกลูโคสในเลือดโดยใช้แหล่งข้อมูลที่สร้างขึ้นข้างต้น
เมธอด HTTP
PATCH
URL คําขอ
https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000
เนื้อความของคำขอ
เพื่อความชัดเจน เนื้อหา JSON ที่แสดงด้านล่างจะมีคําอธิบายประกอบพร้อมความคิดเห็นสําหรับแสดงค่าคงที่ของช่องด้านสุขภาพ แม้ว่าขณะนี้ API ของ Fit จะทิ้งความคิดเห็น แต่ขอแนะนําอย่างยิ่งให้คุณนําความคิดเห็นเหล่านี้ออกจากโค้ด เนื่องจาก JSON จะไม่รองรับความคิดเห็นอย่างเป็นทางการ
{ "minStartTimeNs": 1574159699023000000, "maxEndTimeNs": 1574159699023000000, "dataSourceId": "datasource.dataStreamId", "point": [ { "startTimeNanos": 1574159699023000000, "endTimeNanos": 1574159699023000000, "dataTypeName": "com.google.blood_glucose", "value": [ { // Blood glucose level, 90 mg/dL "fpVal": 5.0 }, { // FIELD_TEMPORAL_RELATION_TO_MEAL_BEFORE_MEAL "intVal": 3 }, { // MEAL_TYPE_BREAKFAST "intVal": 1 }, { // TEMPORAL_RELATION_TO_SLEEP_ON_WAKING "intVal": 3 }, { // BLOOD_GLUCOSE_SPECIMEN_SOURCE_CAPILLARY_BLOOD "intVal": 2 } ] } ] }
คําตอบ
หากเพิ่มข้อมูลน้ําตาลกลูโคสในเลือดสําเร็จ คําตอบจะเป็นรหัสสถานะ 200 OK
เนื้อหาการตอบกลับจะแสดงภาพแทน
น้ําตาลกลูโคสในเลือดที่เพิ่มเข้ามา
คําสั่ง CURL
$ curl --header "Authorization: Bearer ya29.yourtokenvalue --request PATCH \ --header "Content-Type: application/json;encoding=utf-8" --data @blood-glucose-data.json \ https://www.googleapis.com/fitness/v1/users/me/dataSources/datasource.dataStreamId/datasets/1574159699023000000-1574159699023000000