Users.dataSources: update

อัปเดตแหล่งข้อมูลที่ระบุ 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 ตัวระบุที่ไม่ซ้ำกันสําหรับสตรีมข้อมูลที่แหล่งข้อมูลนี้สร้างขึ้น ตัวระบุประกอบด้วย

  • ผู้ผลิต รุ่น และหมายเลขซีเรียล (UID) ของอุปกรณ์จริง
  • ชื่อแพ็กเกจของแอปพลิเคชัน ระบบจะใช้ชื่อแพ็กเกจเมื่อมีการสร้างแหล่งข้อมูลโดยแอปพลิเคชัน Android ระบบจะใช้หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์เมื่อไคลเอ็นต์ REST สร้างแหล่งข้อมูล
  • ประเภทของแหล่งข้อมูล
  • ชื่อสตรีมของแหล่งข้อมูล
โปรดทราบว่าบางแอตทริบิวต์ของแหล่งข้อมูลไม่ได้นำมาใช้เป็นส่วนหนึ่งของตัวระบุสตรีม กล่าวคือ ไม่มีการใช้เวอร์ชันของฮาร์ดแวร์/แอปพลิเคชัน วิธีนี้จะช่วยให้เราใช้งานสตรีมเดิมต่อไปได้ผ่านการอัปเดตเวอร์ชัน นอกจากนี้ยังหมายความว่าออบเจ็กต์แหล่งข้อมูล 2 รายการอาจแสดงสตรีมข้อมูลเดียวกันด้วยแม้ว่าออบเจ็กต์ดังกล่าวจะไม่เท่ากันก็ตาม

รูปแบบที่แน่นอนของรหัสสตรีมข้อมูลที่สร้างขึ้นโดยแอปพลิเคชัน Android คือ type:dataType.name:application.packageName:device.manufacturer:device.model:device.uid:dataStreamName

รูปแบบที่แน่นอนของรหัสสตรีมข้อมูลที่สร้างโดยไคลเอ็นต์ REST คือ type:dataType.name:developer project number:device.manufacturer:device.model:device.uid:dataStreamName

หากไม่มีช่องที่ไม่บังคับซึ่งประกอบขึ้นเป็นรหัสสตรีมข้อมูล ช่องดังกล่าวจะถูกตัดออกจากรหัสสตรีมข้อมูล รหัสสตรีมข้อมูลขั้นต่ำที่ใช้ได้คือ type:dataType.name:developerหมายเลขโปรเจ็กต์

และสุดท้าย หมายเลขโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์และ UID ของอุปกรณ์จะมีความสับสนเมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล เฉพาะผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นหมายเลขโครงการนักพัฒนาซอฟต์แวร์ในรูปแบบปกติและชัดเจน ซึ่งหมายความว่าไคลเอ็นต์จะเห็นชุด data_stream_ids ที่แตกต่างจากไคลเอ็นต์อื่นที่มีข้อมูลเข้าสู่ระบบต่างกัน

dataType nested object ประเภทข้อมูลจะเป็นตัวกำหนดสคีมาสำหรับสตรีมข้อมูลที่มีการรวบรวม แทรก หรือค้นหาจาก Fitness API
dataType.field[] list ช่องหนึ่งจะแสดงมิติข้อมูล 1 รายการของข้อมูลประเภทหนึ่งๆ
dataType.field[].format string รูปแบบที่รองรับที่แตกต่างกันสําหรับแต่ละช่องในประเภทข้อมูล

ค่าที่ยอมรับได้ มีดังนี้
  • "blob"
  • "floatList"
  • "floatPoint"
  • "integer"
  • "integerList"
  • "map"
  • "string"
dataType.field[].name string กำหนดชื่อและรูปแบบข้อมูล ชื่อช่องไม่เหมือนกับชื่อประเภทข้อมูลตรงที่ชื่อช่องไม่ใช่เนมสเปซ และจะต้องไม่ซ้ำกันภายในประเภทข้อมูลเท่านั้น
dataType.name string ข้อมูลแต่ละประเภทมีชื่อที่ไม่ซ้ำกันและเนมสเปซ ระบบจะแชร์ข้อมูลทุกประเภทในเนมสเปซ com.google เป็นส่วนหนึ่งของแพลตฟอร์ม
device nested object ภาพแทนอุปกรณ์ที่ผสานรวม (เช่น โทรศัพท์หรืออุปกรณ์ที่สวมใส่ได้) ที่ยึดเซ็นเซอร์ได้
device.manufacturer string ผู้ผลิตผลิตภัณฑ์/ฮาร์ดแวร์
device.model string ชื่อรุ่นของอุปกรณ์ที่ผู้ใช้ปลายทางมองเห็นได้
device.type string ค่าคงที่ที่แทนประเภทของอุปกรณ์

ค่าที่ยอมรับได้ มีดังนี้
  • "chestStrap"
  • "headMounted"
  • "phone"
  • "scale"
  • "smartDisplay"
  • "tablet"
  • "unknown"
  • "watch"
device.uid string หมายเลขซีเรียลหรือรหัสที่ไม่ซ้ำกันอื่นๆ ของฮาร์ดแวร์ ช่องนี้จะมีการสร้างความสับสนเมื่ออ่านโดย REST หรือไคลเอ็นต์ Android ที่ไม่ได้สร้างแหล่งข้อมูล มีเพียงผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นช่อง uid ในรูปแบบปกติและชัดเจน

การสร้างความสับสนจะช่วยรักษาความเท่าเทียมเอาไว้ นั่นคือ ได้รับสองรหัส ถ้า id1 == id2, obfuscated(id1) == obfuscated(id2)

device.version string สตริงเวอร์ชันสำหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์
type string ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือข้อมูลที่ได้มา

ค่าที่ยอมรับได้ มีดังนี้
  • "derived"
  • "raw"

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากร Users.dataSources ในเนื้อหาการตอบกลับ

ลองใช้งาน

ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบสดและดูการตอบกลับ