สร้างแหล่งข้อมูลใหม่ที่ไม่ซ้ำกันในแหล่งข้อมูลทั้งหมดที่อยู่ใน
ให้ผู้ใช้รายนี้ทราบ
แหล่งข้อมูลคือแหล่งข้อมูลเซ็นเซอร์ที่ไม่ซ้ำกัน แหล่งข้อมูลอาจแสดง
ข้อมูลดิบที่มาจากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ในเครือข่ายเดียวกันหรืออุปกรณ์ที่ใช้ร่วมกัน โฆษณาเหล่านี้
ยังสามารถเปิดเผยข้อมูลที่ได้มาซึ่งสร้างขึ้นโดยการเปลี่ยนรูปแบบหรือรวมข้อมูลอื่นๆ
แหล่งที่มา แหล่งข้อมูลประเภทเดียวกันอาจมีแหล่งข้อมูลหลายแหล่ง ข้อมูลทุกอย่าง
จุดในทุกชุดข้อมูลที่แทรกหรืออ่านจาก Fitness API
แหล่งข้อมูลที่เกี่ยวข้อง
แต่ละแหล่งข้อมูลจะสร้างสตรีมการอัปเดตชุดข้อมูลที่ไม่ซ้ำกัน
ตัวระบุแหล่งข้อมูลที่ไม่ซ้ำกัน การเปลี่ยนแปลงแหล่งข้อมูลบางอย่างอาจไม่ส่งผลกระทบต่อ
รหัสสตรีมข้อมูล เพื่อให้ข้อมูลที่รวบรวมโดยเวอร์ชันที่อัปเดตของ
แอปพลิเคชัน/อุปกรณ์ยังถือว่าเป็นของข้อมูลเดียวกัน
แหล่งที่มา
ระบบจะระบุแหล่งข้อมูลโดยใช้สตริงที่เซิร์ฟเวอร์สร้างขึ้น โดยอิงตาม
เกี่ยวกับเนื้อหาของแหล่งที่มาที่กำลังสร้าง dataStreamId
ไม่ควรตั้งค่าเมื่อเรียกใช้เมธอดนี้ ทั้งนี้
จะถูกสร้างขึ้นโดยอัตโนมัติโดยเซิร์ฟเวอร์ที่มีรูปแบบที่ถูกต้อง ถ้า
มีการตั้งค่า dataStreamId
แล้ว ค่านั้นต้องตรงกับรูปแบบที่
เซิร์ฟเวอร์จะสร้าง รูปแบบนี้เป็นการรวมช่องบางช่องจาก
แหล่งข้อมูล และมีลำดับที่เฉพาะเจาะจง หากไม่ตรงกัน คำขอ
ก็จะล้มเหลวและมีข้อผิดพลาด
การระบุ DataType ที่ไม่ใช่ประเภทที่รู้จัก (ขึ้นต้นด้วย
"com.google.") จะสร้างแหล่งข้อมูลที่มีประเภทข้อมูลที่กำหนดเอง
เฉพาะแอปพลิเคชันที่สร้างประเภทข้อมูลที่กำหนดเองเท่านั้นที่จะอ่านประเภทข้อมูลที่กำหนดเองได้
ประเภทข้อมูลที่กำหนดเองถูกเลิกใช้งาน ใช้ประเภทข้อมูลมาตรฐาน
แทน
นอกจากฟิลด์แหล่งข้อมูลที่รวมอยู่ในรหัสแหล่งข้อมูลแล้ว ฟิลด์
หมายเลขโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์ที่ได้รับการตรวจสอบสิทธิ์เมื่อสร้างข้อมูล
รวมแหล่งที่มาด้วย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์นี้จะมีการปรับให้ยากต่อการอ่าน (Obfuscate) เมื่ออ่านแล้ว
นักพัฒนาซอฟต์แวร์อื่นๆ ที่อ่านประเภทข้อมูลสาธารณะ
ลองใช้เลย
ส่งคำขอ
คำขอ 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 |
ช่องหนึ่งจะแสดงมิติข้อมูล 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 |
หมายเลขซีเรียลหรือรหัสที่ไม่ซ้ำกันอื่นๆ ของฮาร์ดแวร์ ช่องนี้จะมีการสร้างความสับสนเมื่ออ่านโดย REST หรือไคลเอ็นต์ Android ที่ไม่ได้สร้างแหล่งข้อมูล มีเพียงผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นช่อง uid ในรูปแบบปกติและชัดเจน การสร้างความสับสนจะช่วยรักษาความเท่าเทียมเอาไว้ นั่นคือ ได้รับสองรหัส ถ้า id1 == id2, obfuscated(id1) == obfuscated(id2) |
|
device.version |
string |
สตริงเวอร์ชันสำหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์ | |
type |
string |
ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือข้อมูลที่ได้มา
ค่าที่ยอมรับได้ มีดังนี้
|
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงทรัพยากร Users.dataSources ในเนื้อหาการตอบกลับ
ลองใช้งาน
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบสดและดูการตอบกลับ