รูปแบบการส่งออก JSON
เอกสารครบถ้วนสำหรับโครงสร้างรูปแบบการส่งออก JSON
Last updated: April 5, 2026
ในหน้านี้
- โครงสร้างไฟล์
- ประเภทข้อมูล
- ตัวชี้วัดสุขภาพ (<code>metrics</code>)
- การออกกำลังกาย (<code>workouts</code>)
- สภาวะทางจิตใจ (<code>stateOfMind</code>)
- ยา (<code>medications</code>)
- อาการ (<code>symptoms</code>)
- การติดตามรอบเดือน (<code>cycleTracking</code>)
- ECG (<code>ecg</code>)
- การแจ้งเตือนอัตราการเต้นของหัวใจ (<code>heartRateNotifications</code>)
- รูปแบบวันที่
- ทำไมต้องใช้รูปแบบ JSON?
- เริ่มต้นใช้งาน
- เอกสารที่เกี่ยวข้อง
ภาพรวมรูปแบบการส่งออก JSON
เมื่อคุณส่งออกข้อมูลสุขภาพในรูปแบบ JSON ข้อมูลทั้งหมดจะอยู่ในไฟล์เดียวตามโครงสร้างที่นำเข้าฐานข้อมูล วิเคราะห์ด้วยโปรแกรม หรือเชื่อมต่อกับแอปพลิเคชันอื่นได้ง่าย
โครงสร้างไฟล์
ข้อมูลที่ส่งออกทั้งหมดอยู่ภายในอ็อบเจ็กต์ data ซึ่งมีอาร์เรย์สำหรับแต่ละประเภทข้อมูลที่รองรับ:
{
"data": {
"metrics": [],
"workouts": [],
"stateOfMind": [],
"medications": [],
"symptoms": [],
"cycleTracking": [],
"ecg": [],
"heartRateNotifications": []
}
}
ประเภทข้อมูล
รูปแบบการส่งออก JSON รองรับประเภทข้อมูลดังนี้:
ตัวชี้วัดสุขภาพ (metrics)
อาร์เรย์ที่มีข้อมูลตัวชี้วัดสุขภาพทั้งหมด เช่น จำนวนก้าว อัตราการเต้นของหัวใจ ความดันโลหิต การนอน และอื่น ๆ แต่ละตัวชี้วัดมีโครงสร้างร่วมกัน ประกอบด้วยชื่อตัวชี้วัด หน่วย และอาร์เรย์ของจุดข้อมูล
เรียนรู้เพิ่มเติม: เอกสารตัวชี้วัดสุขภาพ
การออกกำลังกาย (workouts)
อาร์เรย์ที่มีเซสชันการออกกำลังกายทั้งหมด รวมถึงประเภทกิจกรรม ระยะเวลา ระยะทาง แคลอรี่ที่เผาผลาญ ข้อมูลอัตราการเต้นของหัวใจ และเส้นทาง (ถ้ามี)
เรียนรู้เพิ่มเติม: เอกสารการออกกำลังกาย
สภาวะทางจิตใจ (stateOfMind)
อาร์เรย์ที่มีรายการอารมณ์และสภาวะจิตใจ รวมถึงคะแนน valence ป้ายกำกับ และความเชื่อมโยง
เรียนรู้เพิ่มเติม: เอกสารสภาวะทางจิตใจ
ยา (medications)
อาร์เรย์ที่มีบันทึกยา รวมถึงชื่อยา ขนาดยา เวลาที่กำหนด และข้อมูลการปฏิบัติตามการรับประทาน
เรียนรู้เพิ่มเติม: เอกสารยา
อาการ (symptoms)
อาร์เรย์ที่มีรายการอาการ พร้อมเวลาเริ่มและสิ้นสุด ความรุนแรง และแหล่งที่มา
เรียนรู้เพิ่มเติม: เอกสารอาการ
การติดตามรอบเดือน (cycleTracking)
อาร์เรย์ที่มีข้อมูลรอบเดือน รวมถึงปริมาณเลือด คุณภาพของเมือกปากมดลูก อุณหภูมิร่างกายพื้นฐาน และผลการทดสอบการตกไข่
เรียนรู้เพิ่มเติม: เอกสารการติดตามรอบเดือน
ECG (ecg)
อาร์เรย์ที่มีการบันทึกคลื่นไฟฟ้าหัวใจจากอุปกรณ์ที่รองรับ รวมถึงการจำแนกประเภท การวัดอัตราการเต้นของหัวใจ และข้อมูลแรงดัน
เรียนรู้เพิ่มเติม: เอกสาร ECG
การแจ้งเตือนอัตราการเต้นของหัวใจ (heartRateNotifications)
อาร์เรย์ที่มีเหตุการณ์แจ้งเตือนอัตราการเต้นสูงและต่ำ รวมถึงเกณฑ์และการวัดโดยละเอียดระหว่างเหตุการณ์
เรียนรู้เพิ่มเติม: เอกสารการแจ้งเตือนอัตราการเต้นของหัวใจ
รูปแบบวันที่
วันที่ทั้งหมดในการส่งออก JSON ใช้รูปแบบดังนี้:
- รูปแบบ:
yyyy-MM-dd HH:mm:ss Z - ตัวอย่าง:
2024-02-06 14:30:00 -0800
รูปแบบนี้ประกอบด้วย:
- วันที่ (ปี-เดือน-วัน)
- เวลา (24 ชั่วโมง: ชั่วโมง:นาที:วินาที)
- เขตเวลา (ออฟเซต)
ทำไมต้องใช้รูปแบบ JSON?
รูปแบบ JSON เหมาะสำหรับ:
- การเก็บในฐานข้อมูล — นำเข้า PostgreSQL, MySQL หรือ MongoDB ได้ง่าย
- การวิเคราะห์ข้อมูล — ใช้กับเครื่องมือวิเคราะห์และภาษาโปรแกรม
- การเชื่อมต่อแอป — แยกวิเคราะห์และใช้ในแอปที่กำหนดเอง
- ข้อมูลละเอียด — รักษาโครงสร้างซ้อนสำหรับเช่น ระยะการนอนและการอ่าน ECG
เริ่มต้นใช้งาน
- ส่งออกข้อมูล ด้วยการส่งออกด้วยตนเองหรือตั้งค่าระบบอัตโนมัติ
- เลือกรูปแบบ JSON เมื่อกำหนดการส่งออก
- เลือก Export Version 2 สำหรับโครงสร้างข้อมูลล่าสุด (แนะนำ)
- อ่านเอกสาร แต่ละประเภทข้อมูลเพื่อเข้าใจโครงสร้าง
เอกสารที่เกี่ยวข้อง
- คู่มือการส่งออกด้วยตนเอง — วิธีส่งออกข้อมูล
- ภาพรวมระบบอัตโนมัติ — ตั้งค่าการส่งออกอัตโนมัติ
- เอกสารแต่ละประเภทข้อมูล (ลิงก์ด้านบน)