การค้นหาจุดข้อมูลของผู้ใช้จะได้รับการเปลี่ยนแปลงในแหล่งข้อมูลบางแห่ง ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
GET https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId/dataPointChanges
พารามิเตอร์
ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
---|---|---|
พารามิเตอร์เส้นทาง | ||
dataSourceId |
string |
รหัสสตรีมข้อมูลของแหล่งข้อมูลที่สร้างชุดข้อมูล |
userId |
string |
แสดงจุดข้อมูลสําหรับบุคคลที่ระบุ ใช้ me เพื่อระบุผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ขณะนี้ระบบรองรับเฉพาะ me เท่านั้น
|
พารามิเตอร์การค้นหาที่ไม่บังคับ | ||
limit |
integer |
หากระบุไว้ จํานวนจุดข้อมูลมากกว่า จะนับรวมในคําตอบ |
pageToken |
string |
โทเค็นความต่อเนื่องซึ่งใช้เพื่อเลื่อนดูชุดผลการค้นหาขนาดใหญ่
หากต้องการดูหน้าถัดไปของผลลัพธ์ ให้ตั้งค่าพารามิเตอร์นี้เป็นค่า nextPageToken จากการตอบกลับก่อนหน้า
|
การให้สิทธิ์
คําขอนี้ต้องให้สิทธิ์ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต
ขอบเขต |
---|
https://www.googleapis.com/auth/fitness.activity.read |
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.read |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.read |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.read |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.read |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.read |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.read |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.read |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.read |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
โปรดดูข้อมูลเพิ่มเติมในหน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
อย่าระบุเนื้อหาคําขอด้วยวิธีนี้
คำตอบ
หากสําเร็จ เมธอดนี้จะแสดงเนื้อหาการตอบกลับโดยมีโครงสร้างดังนี้
{ "insertedDataPoint": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "deletedDataPoint": [ { "startTimeNanos": long, "endTimeNanos": long, "dataTypeName": string, "originDataSourceId": string, "value": [ { "intVal": integer, "fpVal": double, "stringVal": string, "mapVal": [ { "key": string, "value": { "fpVal": double } } ] } ], "modifiedTimeMillis": long, "rawTimestampNanos": long, "computationTimeMillis": long } ], "nextPageToken": string, "dataSourceId": string }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
insertedDataPoint[] |
list |
แทรกจุดข้อมูลสําหรับผู้ใช้แล้ว | |
insertedDataPoint[].startTimeNanos |
long |
เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
insertedDataPoint[].endTimeNanos |
long |
เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
insertedDataPoint[].dataTypeName |
string |
ประเภทข้อมูลที่กําหนดรูปแบบของค่าในจุดข้อมูลนี้ | |
insertedDataPoint[].originDataSourceId |
string |
หากจุดข้อมูลอยู่ในชุดข้อมูลสําหรับแหล่งข้อมูลที่ได้รับข้อมูล ช่องนี้จะสร้างขึ้นด้วยรหัสสตรีมของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก คําเตือน: อย่าพึ่งพาช่องนี้เพื่อจุดประสงค์อื่นนอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากกําหนดไว้จะเป็นรายละเอียดการติดตั้งใช้งานและไม่รับประกันว่าจะสอดคล้องกัน |
|
insertedDataPoint[].value[] |
list |
ค่าของช่องประเภทข้อมูลแต่ละประเภทสําหรับจุดข้อมูล เป็นเรื่องปกติที่แต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นตามลําดับเดียวกันกับที่แสดงในช่องประเภทข้อมูลในแหล่งข้อมูล ระบบจะเติมข้อมูลในช่องจํานวนเต็มและทศนิยมเพียง 1 ช่อง ขึ้นอยู่กับค่าการแจกแจงรูปแบบภายในช่องประเภทข้อมูล |
|
insertedDataPoint[].value[].intVal |
integer |
ค่าจํานวนเต็ม เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ | |
insertedDataPoint[].value[].fpVal |
double |
ค่าของจุดลอยตัว เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ | |
insertedDataPoint[].value[].stringVal |
string |
ค่าสตริง เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ สตริงควรเล็กกระชับทุกครั้งที่ทําได้ สตรีมข้อมูลที่มีค่าสตริงขนาดใหญ่และความถี่ของข้อมูลสูงอาจถูกสุ่มตัวอย่างลงมา | |
insertedDataPoint[].value[].mapVal[] |
list |
ค่าแผนที่ คุณควรระบุพื้นที่คีย์และหน่วยที่ถูกต้องสําหรับค่าที่สอดคล้องกันของแต่ละรายการเป็นส่วนหนึ่งของคําจํากัดความของประเภทข้อมูล กุญแจควรเล็กเสมอเมื่อเป็นไปได้ สตรีมข้อมูลที่มีคีย์ขนาดใหญ่และความถี่ของข้อมูลสูงอาจสุ่มตัวอย่างลดลง | |
insertedDataPoint[].value[].mapVal[].key |
string |
||
insertedDataPoint[].value[].mapVal[].value |
nested object |
||
insertedDataPoint[].value[].mapVal[].value.fpVal |
double |
ค่าของจุดลอยตัว | |
insertedDataPoint[].modifiedTimeMillis |
long |
ระบุเวลาที่แก้ไขจุดข้อมูลครั้งล่าสุด มีประโยชน์ในบริบทที่เราแสดงข้อมูลการเปลี่ยนแปลงข้อมูลเท่านั้น ไม่ได้แสดงถึงสถานะปัจจุบันของข้อมูล | |
insertedDataPoint[].rawTimestampNanos |
long |
การประทับเวลาดิบจาก SensorEvent เดิม | |
insertedDataPoint[].computationTimeMillis |
long |
อย่าใช้ช่องนี้ ระบบจะไม่สนใจและจะไม่จัดเก็บไว้ | |
deletedDataPoint[] |
list |
ลบจุดข้อมูลสําหรับผู้ใช้แล้ว โปรดทราบว่าสําหรับการแก้ไข ควรแยกวิเคราะห์ก่อนจัดการการแทรก | |
deletedDataPoint[].startTimeNanos |
long |
เวลาเริ่มต้นของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
deletedDataPoint[].endTimeNanos |
long |
เวลาสิ้นสุดของช่วงที่แสดงโดยจุดข้อมูลนี้ ในหน่วยนาโนวินาทีนับตั้งแต่เริ่มต้น | |
deletedDataPoint[].dataTypeName |
string |
ประเภทข้อมูลที่กําหนดรูปแบบของค่าในจุดข้อมูลนี้ | |
deletedDataPoint[].originDataSourceId |
string |
หากจุดข้อมูลอยู่ในชุดข้อมูลสําหรับแหล่งข้อมูลที่ได้รับข้อมูล ช่องนี้จะสร้างขึ้นด้วยรหัสสตรีมของแหล่งข้อมูลที่สร้างจุดข้อมูลในตอนแรก คําเตือน: อย่าพึ่งพาช่องนี้เพื่อจุดประสงค์อื่นนอกเหนือจากการแก้ไขข้อบกพร่อง ค่าของช่องนี้หากกําหนดไว้จะเป็นรายละเอียดการติดตั้งใช้งานและไม่รับประกันว่าจะสอดคล้องกัน |
|
deletedDataPoint[].value[] |
list |
ค่าของช่องประเภทข้อมูลแต่ละประเภทสําหรับจุดข้อมูล เป็นเรื่องปกติที่แต่ละค่าที่เกี่ยวข้องกับช่องประเภทข้อมูลจะเกิดขึ้นตามลําดับเดียวกันกับที่แสดงในช่องประเภทข้อมูลในแหล่งข้อมูล ระบบจะเติมข้อมูลในช่องจํานวนเต็มและทศนิยมเพียง 1 ช่อง ขึ้นอยู่กับค่าการแจกแจงรูปแบบภายในช่องประเภทข้อมูล |
|
deletedDataPoint[].value[].intVal |
integer |
ค่าจํานวนเต็ม เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ | |
deletedDataPoint[].value[].fpVal |
double |
ค่าของจุดลอยตัว เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ | |
deletedDataPoint[].value[].stringVal |
string |
ค่าสตริง เมื่อมีการตั้งค่านี้แล้ว จะต้องไม่ได้ตั้งค่าอื่นๆ สตริงควรเล็กกระชับทุกครั้งที่ทําได้ สตรีมข้อมูลที่มีค่าสตริงขนาดใหญ่และความถี่ของข้อมูลสูงอาจถูกสุ่มตัวอย่างลงมา | |
deletedDataPoint[].value[].mapVal[] |
list |
ค่าแผนที่ คุณควรระบุพื้นที่คีย์และหน่วยที่ถูกต้องสําหรับค่าที่สอดคล้องกันของแต่ละรายการเป็นส่วนหนึ่งของคําจํากัดความของประเภทข้อมูล กุญแจควรเล็กเสมอเมื่อเป็นไปได้ สตรีมข้อมูลที่มีคีย์ขนาดใหญ่และความถี่ของข้อมูลสูงอาจสุ่มตัวอย่างลดลง | |
deletedDataPoint[].value[].mapVal[].key |
string |
||
deletedDataPoint[].value[].mapVal[].value |
nested object |
||
deletedDataPoint[].value[].mapVal[].value.fpVal |
double |
ค่าของจุดลอยตัว | |
deletedDataPoint[].modifiedTimeMillis |
long |
ระบุเวลาที่แก้ไขจุดข้อมูลครั้งล่าสุด มีประโยชน์ในบริบทที่เราแสดงข้อมูลการเปลี่ยนแปลงข้อมูลเท่านั้น ไม่ได้แสดงถึงสถานะปัจจุบันของข้อมูล | |
deletedDataPoint[].rawTimestampNanos |
long |
การประทับเวลาดิบจาก SensorEvent เดิม | |
deletedDataPoint[].computationTimeMillis |
long |
อย่าใช้ช่องนี้ ระบบจะไม่สนใจและจะไม่จัดเก็บไว้ | |
nextPageToken |
string |
โทเค็นความต่อเนื่องซึ่งใช้เพื่อเลื่อนดูชุดผลการค้นหาขนาดใหญ่ ระบุค่านี้ในคําขอที่ตามมาเพื่อแสดงผลการค้นหาถัดไป | |
dataSourceId |
string |
รหัสสตรีมข้อมูลของแหล่งข้อมูลที่มีการเปลี่ยนแปลงจุดข้อมูล |
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลสดและดูคําตอบ