อัปเดตแหล่งข้อมูลที่ระบุ แก้ไขพร็อพเพอร์ตี้ dataStreamId
, dataType
, type
, dataStreamName
และ device
ที่มีการยกเว้น version
ไม่ได้
dataStreamId
มีการระบุแหล่งข้อมูล
ลองใช้เลย
ส่งคำขอ
คำขอ HTTP
PUT https://www.googleapis.com/fitness/v1/users/userId/dataSources/dataSourceId
พารามิเตอร์
ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
---|---|---|
พารามิเตอร์เส้นทาง | ||
dataSourceId |
string |
รหัสสตรีมข้อมูลของแหล่งข้อมูลที่จะอัปเดต |
userId |
string |
อัปเดตแหล่งข้อมูลสําหรับบุคคลที่ระบุ ใช้ me เพื่อระบุผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว ขณะนี้ระบบรองรับ me เท่านั้น
|
การให้สิทธิ์
คําขอนี้ต้องให้สิทธิ์ขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต
ขอบเขต |
---|
https://www.googleapis.com/auth/fitness.activity.write |
https://www.googleapis.com/auth/fitness.location.write |
https://www.googleapis.com/auth/fitness.body.write |
https://www.googleapis.com/auth/fitness.nutrition.write |
https://www.googleapis.com/auth/fitness.blood_pressure.write |
https://www.googleapis.com/auth/fitness.blood_glucose.write |
https://www.googleapis.com/auth/fitness.oxygen_saturation.write |
https://www.googleapis.com/auth/fitness.body_temperature.write |
https://www.googleapis.com/auth/fitness.reproductive_health.write |
โปรดดูข้อมูลเพิ่มเติมในหน้าการตรวจสอบสิทธิ์และการให้สิทธิ์
เนื้อหาของคำขอ
ในเนื้อหาคําขอ ให้ระบุทรัพยากร Users.dataSources ด้วยพร็อพเพอร์ตี้ต่อไปนี้
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
พร็อพเพอร์ตี้ที่จําเป็น | |||
application |
nested object |
ข้อมูลเกี่ยวกับแอปพลิเคชันที่ป้อนข้อมูลเซ็นเซอร์ลงในแพลตฟอร์ม | |
application.name |
string |
ชื่อของแอปพลิเคชันนี้ ต้องใช้กับลูกค้า REST แต่เราไม่ได้บังคับใช้ความเป็นเอกลักษณ์ของชื่อนี้ บทความนี้มีไว้เพื่ออํานวยความสะดวกสําหรับนักพัฒนาซอฟต์แวร์รายอื่นที่ต้องการระบุว่า REST ใดสร้างแอปพลิเคชันหรือแหล่งข้อมูล | |
dataStreamId |
string |
ตัวระบุที่ไม่ซ้ํากันสําหรับสตรีมข้อมูลที่สร้างโดยแหล่งข้อมูลนี้ ตัวระบุ ได้แก่
รูปแบบรหัสสตรีมข้อมูลที่สร้างโดยแอปพลิเคชัน Android คือ type:dataType.name รหัสสตรีมรูปแบบที่สร้างโดยไคลเอ็นต์ REST รูปแบบเดียวกันคือ type:dataType.name หากไม่มีช่องที่ไม่บังคับซึ่งประกอบขึ้นเป็นรหัสสตรีมข้อมูล ช่องเหล่านั้นจะไม่รวมอยู่ในรหัสสตรีมข้อมูล รหัสสตรีมข้อมูลขั้นต่ําที่ใช้ได้คือ "type:dataType.name:developer" หมายเลขโปรเจ็กต์ และสุดท้าย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์และ UID ของอุปกรณ์จะมีความสับสนเมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล มีเพียงผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นหมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์ในรูปแบบที่ชัดเจนและปกติ ซึ่งหมายความว่าไคลเอ็นต์จะเห็น data_stream_id คนละชุดกับไคลเอ็นต์อื่นที่มีข้อมูลรับรองต่างกัน |
|
dataType |
nested object |
ประเภทข้อมูลจะเป็นตัวกําหนดสคีมาสําหรับสตรีมข้อมูลที่รวบรวม แทรก หรือสืบค้นจาก Fitness API | |
dataType.field[] |
list |
ช่องข้อมูลจะแสดงมิติข้อมูลประเภทหนึ่ง | |
dataType.field[].format |
string |
รูปแบบที่รองรับที่แตกต่างกันสําหรับแต่ละช่องในประเภทข้อมูล
ค่าที่ยอมรับได้ ได้แก่
|
|
dataType.field[].name |
string |
กําหนดชื่อและรูปแบบของข้อมูล ชื่อช่องจะไม่ได้อยู่ในเนมสเปซและต้องไม่ซ้ํากันภายในประเภทข้อมูล ต่างจากชื่อประเภทข้อมูล | |
dataType.name |
string |
ข้อมูลแต่ละประเภทจะมีเนมสเปซที่มีชื่อไม่ซ้ํากัน ข้อมูลทุกประเภทในเนมสเปซ com.google จะแชร์เป็นส่วนหนึ่งของแพลตฟอร์ม | |
device |
nested object |
การนําเสนออุปกรณ์แบบผสานรวม (เช่น โทรศัพท์หรืออุปกรณ์ที่สวมใส่ได้) ที่รองรับเซ็นเซอร์ได้ | |
device.manufacturer |
string |
ผู้ผลิตผลิตภัณฑ์/ฮาร์ดแวร์ | |
device.model |
string |
ชื่อรุ่นที่ปรากฏของผู้ใช้ปลายทางสําหรับอุปกรณ์ | |
device.type |
string |
ค่าคงที่ที่แสดงถึงประเภทอุปกรณ์
ค่าที่ยอมรับได้ ได้แก่
|
|
device.uid |
string |
หมายเลขซีเรียลหรือรหัสที่ไม่ซ้ํากันอื่นๆ สําหรับฮาร์ดแวร์ ช่องนี้มีการสร้างความสับสนเมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล เฉพาะผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นช่อง UID ในรูปแบบที่ชัดเจนและปกติ การสร้างความสับสนเพื่อรักษาความเท่าเทียมกัน ซึ่งก็คือรหัส 2 รหัส หากรหัส 1 == รหัส 2, ความสับสน(รหัส 1) == ความสับสน(รหัส 2) |
|
device.version |
string |
สตริงเวอร์ชันสําหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์ | |
type |
string |
ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือที่ได้มาหรือไม่
ค่าที่ยอมรับได้ ได้แก่
|
คำตอบ
หากสําเร็จ เมธอดนี้จะแสดงแหล่งข้อมูล Users.dataSources ในเนื้อความการตอบกลับ
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลสดและดูคําตอบ