สร้างแหล่งข้อมูลใหม่ที่ไม่ซ้ํากันในแหล่งข้อมูลทั้งหมดของผู้ใช้รายนี้
แหล่งข้อมูลคือแหล่งข้อมูลเฉพาะของเซ็นเซอร์ แหล่งข้อมูลอาจเปิดเผยข้อมูลข้อมูลดิบจากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ที่ใช้ร่วมกันหรืออุปกรณ์ที่ใช้ร่วมกัน นอกจากนี้ยังอาจเผยให้เห็นข้อมูลที่ได้มาโดยการเปลี่ยนรูปแบบหรือผสานแหล่งข้อมูลอื่นๆ แหล่งข้อมูลประเภทเดียวกันอาจมีได้หลายประเภท จุดข้อมูลทุกจุดในชุดข้อมูลทั้งหมดที่แทรกหรืออ่านจาก 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 |
รูปแบบที่รองรับที่แตกต่างกันสําหรับแต่ละช่องในประเภทข้อมูล
ค่าที่ยอมรับได้ ได้แก่
|
|
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 ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลสดและดูคําตอบ