Users.dataSources: create

สร้างแหล่งข้อมูลใหม่ที่ไม่ซ้ํากันในแหล่งข้อมูลทั้งหมดของผู้ใช้รายนี้

แหล่งข้อมูลคือแหล่งข้อมูลเฉพาะของเซ็นเซอร์ แหล่งข้อมูลอาจเปิดเผยข้อมูลข้อมูลดิบจากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ที่ใช้ร่วมกันหรืออุปกรณ์ที่ใช้ร่วมกัน นอกจากนี้ยังอาจเผยให้เห็นข้อมูลที่ได้มาโดยการเปลี่ยนรูปแบบหรือผสานแหล่งข้อมูลอื่นๆ แหล่งข้อมูลประเภทเดียวกันอาจมีได้หลายประเภท จุดข้อมูลทุกจุดในชุดข้อมูลทั้งหมดที่แทรกหรืออ่านจาก Fitness API จะมีแหล่งข้อมูลที่เกี่ยวข้อง

แหล่งข้อมูลแต่ละแหล่งจะสร้างสตรีมการอัปเดตชุดข้อมูลที่ไม่ซ้ํากัน โดยมีตัวระบุแหล่งข้อมูลที่ไม่ซ้ํากัน การเปลี่ยนแปลงแหล่งข้อมูลบางรายการไม่ได้ส่งผลต่อรหัสสตรีมข้อมูล ดังนั้นข้อมูลที่รวบรวมจากแอปพลิเคชัน/อุปกรณ์เดียวกันที่มีการอัปเดตจะยังถือว่าเป็นของแหล่งข้อมูลเดียวกัน

ระบบจะระบุแหล่งข้อมูลโดยใช้สตริงที่สร้างโดยเซิร์ฟเวอร์ โดยอิงตามเนื้อหาของแหล่งที่มาที่กําลังสร้าง ไม่ควรตั้งค่าช่อง dataStreamId เมื่อเรียกใช้เมธอดนี้ ซึ่งเซิร์ฟเวอร์จะ สร้างขึ้นโดยอัตโนมัติด้วยรูปแบบที่ถูกต้อง หากมีการตั้งค่า dataStreamId ต้องตรงกับรูปแบบที่เซิร์ฟเวอร์จะสร้าง รูปแบบนี้รวมบางช่องจากแหล่งข้อมูลและมีลําดับที่เจาะจง หากไม่ตรงกัน คําขอจะล้มเหลวเพราะข้อผิดพลาด

การระบุ DataType ที่ไม่ใช่ประเภทที่รู้จัก (เริ่มต้นด้วย "com.google.") จะสร้าง DataSource ที่มีประเภทข้อมูลที่กําหนดเอง แอปพลิเคชันที่สร้างขึ้นจะอ่านประเภทข้อมูลที่กําหนดเองได้เท่านั้น ประเภทข้อมูลที่กําหนดเองจะเลิกใช้งาน โปรดใช้ประเภทข้อมูลมาตรฐานแทน

นอกเหนือจากช่องแหล่งข้อมูลที่รวมอยู่ในรหัสแหล่งข้อมูลแล้ว ยังมีหมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์ที่ได้รับการตรวจสอบสิทธิ์เมื่อสร้างแหล่งข้อมูลด้วย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์นี้จะมีความสับสนเมื่ออ่านโดยนักพัฒนาแอปรายอื่นๆ ที่อ่านข้อมูลสาธารณะประเภทต่างๆ ลองใช้เลย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/fitness/v1/users/userId/dataSources

พารามิเตอร์

ชื่อพารามิเตอร์ ค่า คำอธิบาย
พารามิเตอร์เส้นทาง
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 ใดสร้างแอปพลิเคชันหรือแหล่งข้อมูล
dataType nested object ประเภทข้อมูลจะเป็นตัวกําหนดสคีมาสําหรับสตรีมข้อมูลที่รวบรวม แทรก หรือสืบค้นจาก Fitness API
dataType.field[] list ช่องข้อมูลจะแสดงมิติข้อมูลประเภทหนึ่ง
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 ในรูปแบบที่ชัดเจนและปกติ

การสร้างความสับสนเพื่อรักษาความเท่าเทียมกัน ซึ่งก็คือรหัส 2 รหัส หากรหัส 1 == รหัส 2, ความสับสน(รหัส 1) == ความสับสน(รหัส 2)
device.version string สตริงเวอร์ชันสําหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์
type string ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือที่ได้มาหรือไม่

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

คำตอบ

หากสําเร็จ เมธอดนี้จะแสดงแหล่งข้อมูล Users.dataSources ในเนื้อความการตอบกลับ

ลองใช้เลย

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