คําจํากัดความของแหล่งที่มาของข้อมูลเซ็นเซอร์ที่ไม่ซ้ํากัน แหล่งข้อมูลอาจเปิดเผยข้อมูลดิบที่มาจากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ท้องถิ่นหรืออุปกรณ์ที่ใช้ร่วมกัน นอกจากนี้ยังอาจเผยให้เห็นข้อมูลที่ได้มาโดยการเปลี่ยนรูปแบบหรือผสานแหล่งข้อมูลอื่นๆ แหล่งข้อมูลประเภทเดียวกันอาจมีได้หลายประเภท ทุกจุดข้อมูลที่แทรกหรืออ่านจากบริการนี้มีแหล่งข้อมูลที่เชื่อมโยง
แหล่งข้อมูลมีข้อมูลเพียงพอในการระบุข้อมูลที่ไม่ซ้ํากัน ซึ่งรวมถึงอุปกรณ์ฮาร์ดแวร์และแอปพลิเคชันที่รวบรวมและ/หรือเปลี่ยนรูปแบบข้อมูล และยังใช้ข้อมูลเมตาที่เป็นประโยชน์ เช่น เวอร์ชันฮาร์ดแวร์และแอปพลิเคชัน และประเภทอุปกรณ์
แหล่งข้อมูลแต่ละแหล่งจะสร้างสตรีมข้อมูลที่ไม่ซ้ํากันโดยมีตัวระบุที่ไม่ซ้ํากัน การเปลี่ยนแปลงแหล่งข้อมูลบางรายการจะไม่มีผลกับตัวระบุสตรีม ดังนั้นข้อมูลที่รวบรวมจากแอปพลิเคชัน/อุปกรณ์เดียวกันที่มีการอัปเดตจะยังถือว่าเป็นของสตรีมข้อมูลเดียวกัน
ดูรายการเมธอดของทรัพยากรนี้ในส่วนท้ายของหน้านี้
การแสดงแหล่งข้อมูล
{ "dataStreamId": string, "name": string, "dataStreamName": string, "type": string, "dataType": { "name": string, "field": [ { "name": string, "format": string, "optional": boolean } ] }, "device": { "uid": string, "type": string, "version": string, "model": string, "manufacturer": string }, "application": { "packageName": string, "version": string, "detailsUrl": string, "name": string }, "dataQualityStandard": [ string ] }
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | หมายเหตุ |
---|---|---|---|
application |
nested object |
ข้อมูลเกี่ยวกับแอปพลิเคชันที่ป้อนข้อมูลเซ็นเซอร์ลงในแพลตฟอร์ม | |
application.detailsUrl |
string |
URI ทางเลือกที่ใช้สําหรับลิงก์กลับไปที่แอปพลิเคชัน | |
application.name |
string |
ชื่อของแอปพลิเคชันนี้ ต้องใช้กับลูกค้า REST แต่เราไม่ได้บังคับใช้ความเป็นเอกลักษณ์ของชื่อนี้ บทความนี้มีไว้เพื่ออํานวยความสะดวกสําหรับนักพัฒนาซอฟต์แวร์รายอื่นที่ต้องการระบุว่า REST ใดสร้างแอปพลิเคชันหรือแหล่งข้อมูล | |
application.packageName |
string |
ชื่อแพ็กเกจสําหรับแอปพลิเคชันนี้ ซึ่งใช้เป็นตัวระบุที่ไม่ซ้ํากันเมื่อสร้างโดยแอปพลิเคชัน Android แต่จะระบุโดยไคลเอ็นต์ REST ไม่ได้ ไคลเอ็นต์ REST จะมีหมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์ของตนแสดงอยู่ในรหัสสตรีมข้อมูลแหล่งข้อมูล แทนที่จะเป็น packageName | |
application.version |
string |
เวอร์ชันของแอปพลิเคชัน คุณควรอัปเดตช่องนี้เมื่อใดก็ตามที่แอปพลิเคชันมีการเปลี่ยนแปลงในลักษณะที่ส่งผลต่อการคํานวณข้อมูล | |
dataQualityStandard[] |
list |
อย่าป้อนข้อมูลในช่องนี้ และจะไม่มีการสร้างขึ้นในการตอบสนองจากแพลตฟอร์มและจะถูกละเว้นในคําค้นหา เราจะนําเวอร์ชันดังกล่าวออกโดยสมบูรณ์ | |
dataStreamId |
string |
ตัวระบุที่ไม่ซ้ํากันสําหรับสตรีมข้อมูลที่สร้างโดยแหล่งข้อมูลนี้ ตัวระบุ ได้แก่
รูปแบบรหัสสตรีมข้อมูลที่สร้างโดยแอปพลิเคชัน Android คือ type:dataType.name รหัสสตรีมรูปแบบที่สร้างโดยไคลเอ็นต์ REST รูปแบบเดียวกันคือ type:dataType.name หากไม่มีช่องที่ไม่บังคับซึ่งประกอบขึ้นเป็นรหัสสตรีมข้อมูล ช่องเหล่านั้นจะไม่รวมอยู่ในรหัสสตรีมข้อมูล รหัสสตรีมข้อมูลขั้นต่ําที่ใช้ได้คือ "type:dataType.name:developer" หมายเลขโปรเจ็กต์ และสุดท้าย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์และ UID ของอุปกรณ์จะมีความสับสนเมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล มีเพียงผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นหมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์ในรูปแบบที่ชัดเจนและปกติ ซึ่งหมายความว่าไคลเอ็นต์จะเห็น data_stream_id คนละชุดกับไคลเอ็นต์อื่นที่มีข้อมูลรับรองต่างกัน |
|
dataStreamName |
string |
ชื่อสตรีมจะระบุแหล่งข้อมูลนี้โดยเฉพาะจากแหล่งข้อมูลอื่นในประเภทเดียวกันจากผู้ผลิตเดียวกัน คุณไม่จําเป็นต้องระบุชื่อสตรีม แต่ควรทําเมื่อแอปพลิเคชันแสดงสตรีม 2 สตรีมสําหรับข้อมูลประเภทเดียวกัน หรือเมื่ออุปกรณ์มีเซ็นเซอร์ 2 ตัวที่เทียบเท่ากัน | |
dataType |
nested object |
ประเภทข้อมูลจะเป็นตัวกําหนดสคีมาสําหรับสตรีมข้อมูลที่รวบรวม แทรก หรือสืบค้นจาก Fitness API | |
dataType.field[] |
list |
ช่องข้อมูลจะแสดงมิติข้อมูลประเภทหนึ่ง | |
dataType.field[].format |
string |
รูปแบบที่รองรับที่แตกต่างกันสําหรับแต่ละช่องในประเภทข้อมูล
ค่าที่ยอมรับได้ ได้แก่
|
|
dataType.field[].name |
string |
กําหนดชื่อและรูปแบบของข้อมูล ชื่อช่องจะไม่ได้อยู่ในเนมสเปซและต้องไม่ซ้ํากันภายในประเภทข้อมูล ต่างจากชื่อประเภทข้อมูล | |
dataType.field[].optional |
boolean |
||
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 |
สตริงเวอร์ชันสําหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์ | |
name |
string |
ชื่อที่ผู้ใช้ปลายทางจะเห็นสําหรับแหล่งข้อมูลนี้ | |
type |
string |
ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือที่ได้มาหรือไม่
ค่าที่ยอมรับได้ ได้แก่
|
เมธอด
- สร้าง
- สร้างแหล่งข้อมูลใหม่ที่ไม่ซ้ํากันในแหล่งข้อมูลทั้งหมดของผู้ใช้รายนี้
แหล่งข้อมูลคือแหล่งข้อมูลเฉพาะของเซ็นเซอร์ แหล่งข้อมูลอาจเปิดเผยข้อมูลข้อมูลดิบจากเซ็นเซอร์ฮาร์ดแวร์ในอุปกรณ์ที่ใช้ร่วมกันหรืออุปกรณ์ที่ใช้ร่วมกัน นอกจากนี้ยังอาจเผยให้เห็นข้อมูลที่ได้มาโดยการเปลี่ยนรูปแบบหรือผสานแหล่งข้อมูลอื่นๆ แหล่งข้อมูลประเภทเดียวกันอาจมีได้หลายประเภท จุดข้อมูลทุกจุดในชุดข้อมูลทั้งหมดที่แทรกหรืออ่านจาก Fitness API จะมีแหล่งข้อมูลที่เกี่ยวข้อง
แหล่งข้อมูลแต่ละแหล่งจะสร้างสตรีมการอัปเดตชุดข้อมูลที่ไม่ซ้ํากัน โดยมีตัวระบุแหล่งข้อมูลที่ไม่ซ้ํากัน การเปลี่ยนแปลงแหล่งข้อมูลบางรายการไม่ได้ส่งผลต่อรหัสสตรีมข้อมูล ดังนั้นข้อมูลที่รวบรวมจากแอปพลิเคชัน/อุปกรณ์เดียวกันที่มีการอัปเดตจะยังถือว่าเป็นของแหล่งข้อมูลเดียวกัน
ระบบจะระบุแหล่งข้อมูลโดยใช้สตริงที่สร้างโดยเซิร์ฟเวอร์ โดยอิงตามเนื้อหาของแหล่งที่มาที่กําลังสร้าง ไม่ควรตั้งค่าช่องdataStreamId
เมื่อเรียกใช้เมธอดนี้ ซึ่งเซิร์ฟเวอร์จะ สร้างขึ้นโดยอัตโนมัติด้วยรูปแบบที่ถูกต้อง หากมีการตั้งค่าdataStreamId
ต้องตรงกับรูปแบบที่เซิร์ฟเวอร์จะสร้าง รูปแบบนี้รวมบางช่องจากแหล่งข้อมูลและมีลําดับที่เจาะจง หากไม่ตรงกัน คําขอจะล้มเหลวเพราะข้อผิดพลาด
การระบุ DataType ที่ไม่ใช่ประเภทที่รู้จัก (เริ่มต้นด้วย "com.google.") จะสร้าง DataSource ที่มีประเภทข้อมูลที่กําหนดเอง แอปพลิเคชันที่สร้างขึ้นจะอ่านประเภทข้อมูลที่กําหนดเองได้เท่านั้น ประเภทข้อมูลที่กําหนดเองจะเลิกใช้งาน โปรดใช้ประเภทข้อมูลมาตรฐานแทน
นอกเหนือจากช่องแหล่งข้อมูลที่รวมอยู่ในรหัสแหล่งข้อมูลแล้ว ยังมีหมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์ที่ได้รับการตรวจสอบสิทธิ์เมื่อสร้างแหล่งข้อมูลด้วย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์นี้จะมีความสับสนเมื่ออ่านโดยนักพัฒนาแอปรายอื่นๆ ที่อ่านข้อมูลสาธารณะประเภทต่างๆ - ลบ
- ลบแหล่งข้อมูลที่ระบุ คําขอจะล้มเหลวหากแหล่งข้อมูลมีจุดข้อมูลอยู่
- รับ
- ส่งคืนแหล่งข้อมูลที่ระบุ
- list
- แสดงแหล่งข้อมูลทั้งหมดที่นักพัฒนาแอปเห็นโดยใช้ขอบเขต OAuth ที่ให้ไว้ รายการนี้ยังไม่ครบทั้งหมด ผู้ใช้อาจมีแหล่งข้อมูลส่วนตัวที่มองเห็นได้เฉพาะนักพัฒนาแอปรายอื่นๆ หรือการโทรโดยใช้ขอบเขตอื่นๆ
- อัปเดต
- อัปเดตแหล่งข้อมูลที่ระบุ แก้ไขพร็อพเพอร์ตี้
dataStreamId
,dataType
,type
,dataStreamName
และdevice
ที่มีการยกเว้นversion
ไม่ได้
dataStreamId
มีการระบุแหล่งข้อมูล