อัปเดตแหล่งข้อมูลที่ระบุ แก้ไขพร็อพเพอร์ตี้ 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 ที่มีพร็อพเพอร์ตี้ต่อไปนี้
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
พร็อพเพอร์ตี้ที่จำเป็น | |||
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_ids ต่างจากไคลเอ็นต์อีกรายที่มีข้อมูลเข้าสู่ระบบต่างกัน |
|
dataType |
nested object |
ประเภทข้อมูลจะกำหนดสคีมาสำหรับสตรีมข้อมูลที่รวบรวมโดย แทรก หรือสอบถามจาก Fitness API | |
dataType.field[] |
list |
ช่องจะแสดงมิติข้อมูล 1 รายการของประเภทข้อมูล | |
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 |
หมายเลขซีเรียลหรือรหัสที่ไม่ซ้ำกันอื่นๆ สำหรับฮาร์ดแวร์ ช่องนี้จะมีการปรับให้ยากต่อการอ่าน (Obfuscate) เมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล เฉพาะผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นช่อง UID ในรูปแบบปกติและชัดเจน การสร้างความสับสนจะรักษาความเท่าเทียม กล่าวคือ หากเป็น 2 รหัส หาก id1 == id2, obfuscated(id1) == obfuscated(id2) |
|
device.version |
string |
สตริงเวอร์ชันสำหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์ | |
type |
string |
การอธิบายประเภทของแหล่งข้อมูลนี้อย่างต่อเนื่อง ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือข้อมูลที่ได้รับมา
ค่าที่ยอมรับมีดังนี้
|
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงผลทรัพยากร Users.dataSources ในเนื้อหาการตอบสนอง
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้ในข้อมูลสดและดูการตอบสนอง