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 จะแสดงหมายเลขโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์ในรหัสสตรีมข้อมูลของแหล่งข้อมูล แทนชื่อแพ็กเกจ
application.version string เวอร์ชันของแอปพลิเคชัน คุณควรอัปเดตฟิลด์นี้เมื่อแอปพลิเคชันมีการเปลี่ยนแปลงในลักษณะที่ส่งผลต่อการคำนวณข้อมูล
dataQualityStandard[] list ไม่ป้อนข้อมูลในช่องนี้ และจะไม่มีการป้อนข้อมูลนี้ในคำตอบจากแพลตฟอร์ม และระบบจะไม่นำมาพิจารณาในคำค้นหา ซึ่งจะนําออกในเวอร์ชันในอนาคตทั้งหมด
dataStreamId string ตัวระบุที่ไม่ซ้ำกันสําหรับสตรีมข้อมูลที่แหล่งข้อมูลนี้สร้างขึ้น ตัวระบุประกอบด้วย

  • ผู้ผลิต รุ่น และหมายเลขซีเรียล (UID) ของอุปกรณ์จริง
  • ชื่อแพ็กเกจของแอปพลิเคชัน ระบบจะใช้ชื่อแพ็กเกจเมื่อมีการสร้างแหล่งข้อมูลโดยแอปพลิเคชัน Android ระบบจะใช้หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์เมื่อไคลเอ็นต์ REST สร้างแหล่งข้อมูล
  • ประเภทของแหล่งข้อมูล
  • ชื่อสตรีมของแหล่งข้อมูล
โปรดทราบว่าบางแอตทริบิวต์ของแหล่งข้อมูลไม่ได้นำมาใช้เป็นส่วนหนึ่งของตัวระบุสตรีม กล่าวคือ ไม่มีการใช้เวอร์ชันของฮาร์ดแวร์/แอปพลิเคชัน วิธีนี้จะช่วยให้เราใช้งานสตรีมเดิมต่อไปได้ผ่านการอัปเดตเวอร์ชัน นอกจากนี้ยังหมายความว่าออบเจ็กต์แหล่งข้อมูล 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_ids ที่แตกต่างจากไคลเอ็นต์อื่นที่มีข้อมูลเข้าสู่ระบบต่างกัน

dataStreamName string ชื่อสตรีมจะระบุแหล่งข้อมูลเฉพาะนี้โดยไม่ซ้ำกัน รวมถึงแหล่งข้อมูลอื่นๆ ที่เป็นประเภทเดียวกันจากผู้ผลิตรายเดียวกัน คุณจะตั้งชื่อสตรีมหรือไม่ก็ได้ แต่ควรทำเมื่อแอปพลิเคชันแสดงสตรีม 2 รายการสำหรับข้อมูลประเภทเดียวกัน หรือเมื่ออุปกรณ์มีเซ็นเซอร์ 2 ตัวที่เทียบเท่ากัน
dataType nested object ประเภทข้อมูลจะเป็นตัวกำหนดสคีมาสำหรับสตรีมข้อมูลที่มีการรวบรวม แทรก หรือค้นหาจาก Fitness API
dataType.field[] list ช่องหนึ่งจะแสดงมิติข้อมูล 1 รายการของข้อมูลประเภทหนึ่งๆ
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 ในรูปแบบปกติและชัดเจน

การสร้างความสับสนจะช่วยรักษาความเท่าเทียมเอาไว้ นั่นคือ ได้รับสองรหัส ถ้า id1 == id2, obfuscated(id1) == obfuscated(id2)

device.version string สตริงเวอร์ชันสำหรับฮาร์ดแวร์/ซอฟต์แวร์ของอุปกรณ์
name string ชื่อที่ผู้ใช้ปลายทางเห็นของแหล่งข้อมูลนี้
type string ค่าคงที่ที่อธิบายประเภทของแหล่งข้อมูลนี้ ระบุว่าแหล่งข้อมูลนี้สร้างข้อมูลดิบหรือข้อมูลที่ได้มา

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

เมธอด

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

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

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

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

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

นอกจากฟิลด์แหล่งข้อมูลที่รวมอยู่ในรหัสแหล่งข้อมูลแล้ว ฟิลด์ หมายเลขโปรเจ็กต์ของนักพัฒนาซอฟต์แวร์ที่ได้รับการตรวจสอบสิทธิ์เมื่อสร้างข้อมูล รวมแหล่งที่มาด้วย หมายเลขโปรเจ็กต์นักพัฒนาซอฟต์แวร์นี้จะมีการปรับให้ยากต่อการอ่าน (Obfuscate) เมื่ออ่านแล้ว นักพัฒนาซอฟต์แวร์อื่นๆ ที่อ่านประเภทข้อมูลสาธารณะ
ลบ
ลบแหล่งข้อมูลที่ระบุ คำขอจะล้มเหลวหากข้อมูล แหล่งข้อมูลมีจุดข้อมูลใดๆ อยู่
รับ
แสดงผลแหล่งข้อมูลที่ระบุ
list
แสดงรายการแหล่งข้อมูลทั้งหมดที่นักพัฒนาซอฟต์แวร์มองเห็นได้ โดยใช้ OAuth ที่มีให้ รายการนี้เป็นเพียงตัวอย่างบางส่วนเท่านั้น ผู้ใช้อาจมีโปรไฟล์ส่วนตัว แหล่งข้อมูลที่แสดงเฉพาะแก่นักพัฒนาซอฟต์แวร์รายอื่น หรือการเรียกโดยใช้ ขอบเขตอื่นๆ
อัปเดต
อัปเดตแหล่งข้อมูลที่ระบุ dataStreamId dataType, type, dataStreamName และ ที่พัก device รายการ ยกเว้น version ไม่สามารถแก้ไขได้

แหล่งข้อมูลจะระบุโดยdataStreamId