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