Users.dataSources

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

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

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

ดูรายการเมธอดของทรัพยากรนี้ในส่วนท้ายของหน้านี้

การแสดงแหล่งข้อมูล

{
  "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	ตัวระบุที่ไม่ซ้ํากันสําหรับสตรีมข้อมูลที่สร้างโดยแหล่งข้อมูลนี้ ตัวระบุ ได้แก่ ผู้ผลิต รุ่น และหมายเลขซีเรียล (UID) ของอุปกรณ์จริง ชื่อแพ็กเกจหรือชื่อแอปพลิเคชัน มีการใช้ชื่อแพ็กเกจเมื่อแอปพลิเคชัน Android สร้างแหล่งข้อมูล ระบบจะใช้หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์เมื่อไคลเอ็นต์ REST สร้างแหล่งข้อมูล ประเภทของแหล่งข้อมูล ชื่อสตรีมของแหล่งข้อมูล โปรดทราบว่าแอตทริบิวต์แหล่งข้อมูลไม่ได้นํามาใช้เป็นส่วนหนึ่งของตัวระบุสตรีมบางรายการ โดยเฉพาะอย่างยิ่ง เวอร์ชันฮาร์ดแวร์/แอปพลิเคชันที่ไม่ได้ใช้ วิธีนี้ช่วยให้เรารักษาสตรีมเดียวกันไว้ด้วยการอัปเดตเวอร์ชัน ซึ่งหมายความว่าออบเจ็กต์ DataSource 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_id คนละชุดกับไคลเอ็นต์อื่นที่มีข้อมูลรับรองต่างกัน
dataStreamName	string	ชื่อสตรีมจะระบุแหล่งข้อมูลนี้โดยเฉพาะจากแหล่งข้อมูลอื่นในประเภทเดียวกันจากผู้ผลิตเดียวกัน คุณไม่จําเป็นต้องระบุชื่อสตรีม แต่ควรทําเมื่อแอปพลิเคชันแสดงสตรีม 2 สตรีมสําหรับข้อมูลประเภทเดียวกัน หรือเมื่ออุปกรณ์มีเซ็นเซอร์ 2 ตัวที่เทียบเท่ากัน
dataType	nested object	ประเภทข้อมูลจะเป็นตัวกําหนดสคีมาสําหรับสตรีมข้อมูลที่รวบรวม แทรก หรือสืบค้นจาก Fitness API
dataType.field[]	list	ช่องข้อมูลจะแสดงมิติข้อมูลประเภทหนึ่ง
dataType.field[].format	string	รูปแบบที่รองรับที่แตกต่างกันสําหรับแต่ละช่องในประเภทข้อมูล ค่าที่ยอมรับได้ ได้แก่ "blob" "floatList" "floatPoint" "integer" "integerList" "map" "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	ค่าคงที่ที่แสดงถึงประเภทอุปกรณ์ ค่าที่ยอมรับได้ ได้แก่ "chestStrap" "headMounted" "phone" "scale" "smartDisplay" "tablet" "unknown" "watch"
device.uid	string	หมายเลขซีเรียลหรือรหัสที่ไม่ซ้ํากันอื่นๆ สําหรับฮาร์ดแวร์ ช่องนี้มีการสร้างความสับสนเมื่ออ่านโดยไคลเอ็นต์ REST หรือ Android ที่ไม่ได้สร้างแหล่งข้อมูล เฉพาะผู้สร้างแหล่งข้อมูลเท่านั้นที่จะเห็นช่อง UID ในรูปแบบที่ชัดเจนและปกติ การสร้างความสับสนเพื่อรักษาความเท่าเทียมกัน ซึ่งก็คือรหัส 2 รหัส หากรหัส 1 == รหัส 2, ความสับสน(รหัส 1) == ความสับสน(รหัส 2)
device.version	string	สตริงเวอร์ชันสําหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์
name	string	ชื่อที่ผู้ใช้ปลายทางจะเห็นสําหรับแหล่งข้อมูลนี้
type	string	ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือที่ได้มาหรือไม่ ค่าที่ยอมรับได้ ได้แก่ "derived" "raw"

เมธอด

สร้าง

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

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

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

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

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

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

ลบ

ลบแหล่งข้อมูลที่ระบุ คําขอจะล้มเหลวหากแหล่งข้อมูลมีจุดข้อมูลอยู่

รับ

ส่งคืนแหล่งข้อมูลที่ระบุ

list

แสดงแหล่งข้อมูลทั้งหมดที่นักพัฒนาแอปเห็นโดยใช้ขอบเขต OAuth ที่ให้ไว้ รายการนี้ยังไม่ครบทั้งหมด ผู้ใช้อาจมีแหล่งข้อมูลส่วนตัวที่มองเห็นได้เฉพาะนักพัฒนาแอปรายอื่นๆ หรือการโทรโดยใช้ขอบเขตอื่นๆ

อัปเดต

อัปเดตแหล่งข้อมูลที่ระบุ แก้ไขพร็อพเพอร์ตี้ dataStreamId, dataType, type, dataStreamName และ device ที่มีการยกเว้น version ไม่ได้

dataStreamId มีการระบุแหล่งข้อมูล