เกี่ยวกับ Google Health API

Fitbit Web API ได้รับการปรับปรุงและปรับให้ทันสมัยเพื่อให้มีรากฐานที่เป็นมาตรฐาน สอดคล้อง และปรับขนาดได้มากขึ้นสำหรับการผสานรวมของนักพัฒนาซอฟต์แวร์ และตอนนี้เรียกว่า Google Health API Google Health API แสดงถึงวิวัฒนาการเชิงกลยุทธ์ของ Fitbit Web API เดิม ซึ่งสร้างขึ้นใหม่ตั้งแต่ต้นบนโครงสร้างพื้นฐานที่ทันสมัยของ Google

แพลตฟอร์มนี้ช่วยให้นักพัฒนาซอฟต์แวร์เข้าถึงศักยภาพทั้งหมดของเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Google Cloud และความสะดวกสบายในรูปแบบที่คุ้นเคยและมีประสิทธิภาพสำหรับผู้ใช้ในการจัดการสิทธิ์ผ่าน Google OAuth 2.0

สิ่งที่คุณจะได้รับจาก Google Health API

  • แหล่งข้อมูลที่ถูกต้องแบบรวม: "สตรีมที่ปรับยอดแล้ว" ใหม่ของเราจะจัดการงานที่ซับซ้อนในการปรับยอดจุดข้อมูลที่ทับซ้อนกันจากหลายแหล่ง ซึ่งจะช่วยให้แอปแสดงข้อมูลที่สอดคล้องกันกับที่ผู้ใช้เห็นในแอป Fitbit สตรีมนี้จะให้บริการเพิ่มเติมจากสตรีมของบุคคลที่หนึ่งซึ่งรวมถึงข้อมูลจากอุปกรณ์ Fitbit และ Pixel ตลอดจนรายการที่ป้อนด้วยตนเอง
  • ความทันสมัยทางเทคนิคและประสิทธิภาพ: เราได้รวมปลายทางเดิมกว่า 100 รายการไว้ในชุดแพ็กเกจประเภทข้อมูลที่เรียบง่ายและมีประสิทธิภาพมากขึ้น รวมถึงขจัดความไม่สอดคล้องกันในรูปแบบข้อมูล เขตเวลา หน่วยวัด และการจัดการข้อผิดพลาด นอกจากนี้ เรายังรองรับโปรโตคอล HTTP/REST สำหรับการดึงข้อมูลที่มีประสิทธิภาพสูงด้วย นอกจากนี้ ข้อมูลระหว่างวันและเว็บฮุคเผยแพร่แล้วสำหรับข้อมูลทุกประเภทที่เกี่ยวข้องผ่านปลายทางรายการเฉพาะ
  • เว็บฮุคที่ได้รับการปรับปรุงและความสามารถในการปรับขนาด: รับประโยชน์จากการรองรับเว็บฮุคที่ขยายเพิ่มขึ้น ซึ่งรวมถึงการสมัครใช้บริการอัตโนมัติและการจัดการโดยละเอียดสำหรับข้อมูลทุกประเภทที่เกี่ยวข้อง ซึ่งออกแบบมาเพื่อปรับขนาดตามแอปสุขภาพที่ทำงานด้วยระบบ AI รุ่นถัดไป
  • การระบุตัวตนและความปลอดภัยที่มีประสิทธิภาพ: แทนที่การให้สิทธิ์ Fitbit (FOT) เดิมด้วย Google OAuth 2.0 ซึ่งช่วยให้นักพัฒนาแอปใช้ไลบรารีการตรวจสอบสิทธิ์มาตรฐานของ Google ได้ ซึ่งจะช่วยลดความซับซ้อนของฐานของโค้ดและมอบวิธีที่คุ้นเคยและรวมศูนย์ให้แก่ผู้ใช้ในการจัดการสิทธิ์ของตน ขอบเขต Google Health API ทั้งหมดจัดอยู่ในประเภท "ถูกจำกัด" ซึ่งจำเป็นต้องมีการตรวจสอบความเป็นส่วนตัวและความปลอดภัยสำหรับการเข้าถึง

ชอบสิ่งที่คุณเห็นใช่ไหม เริ่มต้นใช้งานเลย

เวอร์ชัน API และเวอร์ชันเบต้าสำหรับผู้ใช้ทั่วไป

Google Health API ใช้การกำหนดเวอร์ชันตามแชแนลตามข้อเสนอการปรับปรุง API (AIP) ของ Google โดยเฉพาะ AIP-185: การกำหนดเวอร์ชัน API และ AIP-181: ระดับความเสถียร API พร้อมใช้งานในช่องทางสาธารณะ 2 ช่องทาง ได้แก่ ช่องทาง v4 ที่เสถียรและช่องทาง v4beta เวอร์ชันเบต้าสาธารณะ Google รองรับทั้ง 2 ช่องทางผ่านช่องทางการสนับสนุนมาตรฐาน

เปรียบเทียบเวอร์ชันเสถียรและเวอร์ชันเบต้า

ตาม AIP-185 ช่องทาง v4beta จะทำหน้าที่เป็นซูเปอร์เซ็ตของช่องทาง v4 ที่เสถียร ซึ่งรวมถึงฟังก์ชันการทำงาน v4 ที่เสถียรทั้งหมด รวมถึงประเภทข้อมูล ฟิลด์ และเมธอดที่อยู่ระหว่างการทดลองใช้ก่อนเปิดตัวซึ่งอยู่ระหว่างการทดสอบของพาร์ทเนอร์

ในเอกสารประกอบ องค์ประกอบ API ที่มีเฉพาะในเวอร์ชันเบต้าจะแสดงป้ายกำกับ v4beta

ฟีเจอร์ เวอร์ชันเสถียร (v4) เวอร์ชันเบต้าสาธารณะ (v4beta)
URI ฐาน REST https://health.googleapis.com/v4 https://health.googleapis.com/v4beta
แพ็กเกจ gRPC google.devicesandservices.health.v4 google.devicesandservices.health.v4beta
เอกสารอ้างอิง v4 REST และ v4 RPC v4beta REST และ v4beta RPC
ระดับความเสถียร พร้อมใช้งานจริงและอยู่ในบังคับของกฎความเข้ากันได้แบบย้อนหลัง AIP-180 เวอร์ชันตัวอย่างที่ไม่เสถียรอาจมีการเปลี่ยนแปลงที่เข้ากันไม่ได้หรือถูกนำออกได้ทุกเมื่อโดยไม่ต้องแจ้งให้ทราบ
จุดประสงค์ในการใช้ แอปพลิเคชันเวอร์ชันที่ใช้งานจริงซึ่งแสดงต่อผู้ใช้ การทดสอบระยะเริ่มต้น การสร้างต้นแบบ การตรวจสอบสคีมา และความคิดเห็นของนักพัฒนาแอป
การสนับสนุน รองรับผ่านช่องทางการสนับสนุนมาตรฐาน รองรับผ่านช่องทางการสนับสนุนมาตรฐานสำหรับการรายงานข้อบกพร่อง การแก้ปัญหา และความคิดเห็นเกี่ยวกับการออกแบบ

วิธีจัดการช่อง v4beta

เมื่อสำรวจความสามารถที่ติดแท็กด้วย v4beta ให้ทำตามหลักเกณฑ์ต่อไปนี้

  • ใช้ v4beta เป็นหลักในสภาพแวดล้อมการพัฒนา การทดลองใช้ และการทดสอบที่ไม่ใช่เวอร์ชันที่ใช้งานจริง เราไม่แนะนำให้จัดส่งฟีเจอร์เวอร์ชันที่ใช้งานจริงซึ่งขึ้นอยู่กับปลายทาง v4beta หรือประเภทข้อมูลเฉพาะเวอร์ชันเบต้า
  • สคีมา ชื่อฟิลด์ ลักษณะการทำงานของปลายทาง และการแสดงข้อมูลใน v4beta อาจมีการเปลี่ยนแปลงโดยไม่มีการเตือนล่วงหน้า นอกจากนี้ เรายังอาจนำฟีเจอร์และประเภทข้อมูลเวอร์ชันเบต้าออกทั้งหมดหากไม่เป็นไปตามเป้าหมายการตรวจสอบความถูกต้อง
  • แยกโค้ดไคลเอ็นต์ v4beta เวอร์ชันทดลองไว้หลังแฟล็กฟีเจอร์หรือแยกโมดูล เพื่อไม่ให้การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบในเวอร์ชันเบต้าขัดจังหวะการผสานรวม v4 หลัก
  • รับการสนับสนุน รายงานปัญหา และแชร์ความคิดเห็นเกี่ยวกับการใช้งาน v4beta ผ่านช่องทางการสนับสนุนมาตรฐานของเราเพื่อช่วยกำหนดรูปแบบการออกแบบ API ขั้นสุดท้าย

การโปรโมตจาก v4beta เป็น v4 ที่เสถียร

ประเภทข้อมูลและฟีเจอร์ใหม่จะเข้าสู่v4betaเพื่อรองรับการทดสอบของพาร์ทเนอร์และการตรวจสอบความถูกต้องของตลาดก่อนที่จะเปลี่ยนไปใช้เวอร์ชันเสถียรของ v4

Google จะประเมินฟีเจอร์เบต้าตามเกณฑ์ต่อไปนี้ก่อนที่จะโปรโมตเป็น v4

  • การทดสอบของพาร์ทเนอร์จะยืนยันว่าโมเดลข้อมูล ความหมายของฟิลด์ และรูปแบบการค้นหาเป็นไปตามข้อกำหนดของแอปพลิเคชันในชีวิตจริง
  • ความคิดเห็นของนักพัฒนาซอฟต์แวร์และการตรวจสอบการออกแบบเสร็จสมบูรณ์แล้ว และสคีมาพร้อมที่จะล็อกภายใต้การรับประกันความเข้ากันได้แบบย้อนหลังของ AIP-180
  • Data Pipeline แบบครบวงจร การซิงค์อุปกรณ์ และความน่าเชื่อถือของบริการเป็นไปตามมาตรฐานคุณภาพการผลิต
  • เพื่อให้สอดคล้องกับกฎการเลิกใช้งาน AIP-185 ระบบจะนำช่องหรือลักษณะการทำงานที่เลิกใช้งานระหว่างการทดสอบเบต้าออกแทนที่จะเลื่อนเป็น v4

แม้ว่า AIP-181 จะให้กฎทั่วไปโดยประมาณ 90 วันสำหรับการประเมินเวอร์ชันเบต้า แต่เวลาจริงในการโปรโมตฟีเจอร์จาก v4beta เป็น v4 จะขึ้นอยู่กับความซับซ้อนของฟีเจอร์ ความพร้อมใช้งานของฮาร์ดแวร์ และความคิดเห็นเกี่ยวกับการตรวจสอบความถูกต้อง ฟีเจอร์บางอย่างอาจพร้อมใช้งานเร็วกว่าฟีเจอร์อื่นๆ ขณะที่บางฟีเจอร์อาจอยู่ในv4betaนานกว่าหรืออาจหยุดให้บริการ

เมื่อประเภทข้อมูลหรือฟีเจอร์ได้รับการเลื่อนขั้นเป็นเวอร์ชันเสถียร v4 Google จะประกาศการเลื่อนขั้นในบันทึกประจำรุ่น เมื่อถึงตอนนั้น ให้อัปเดตคำขอจาก https://health.googleapis.com/v4beta เป็น https://health.googleapis.com/v4 ก่อนที่จะเผยแพร่การผสานรวมไปยังผู้ใช้เวอร์ชันที่ใช้งานจริง

แล้ว Fitbit Web API ล่ะ

Fitbit Web API เดิมถูกปิดตามลำดับเวลาต่อไปนี้

  • 30 กันยายน 2026 (สิ้นสุดการรองรับ): การรองรับ Fitbit Web API สิ้นสุดลง และ Google หยุดแก้ไขข้อบกพร่องหรือให้การสนับสนุน API
  • 2 พฤศจิกายน 2026 (การปิด API): ระบบจะปิด Fitbit Web API และปลายทาง Fitbit OAuth และจะไม่ทำงานหรือซิงค์ข้อมูลกับผู้ใช้ Google Health อีกต่อไป คำขอไปยังปลายทางเหล่านี้จะดำเนินการไม่สำเร็จและแสดงรหัสสถานะ HTTP 410 Gone

นักพัฒนาแอปที่ใช้ Fitbit Web API และการให้สิทธิ์ Fitbit เดิมควรย้ายข้อมูลแอปพลิเคชันและผู้ใช้ไปยัง Google Health API และ Google OAuth 2.0

ดูคำแนะนำในการย้ายข้อมูลเพื่อเริ่มต้นใช้งาน

ใช้กับอุปกรณ์ใดได้บ้าง

อุปกรณ์ Fitbit และ Google Pixel Watch ทั้งหมด ทั้งรุ่นปัจจุบันและรุ่นก่อนหน้า จะรวบรวมข้อมูลที่แสดงผลผ่าน Google Health API ประเภทข้อมูลที่ใช้ได้จะขึ้นอยู่กับฟังก์ชันการทำงานที่อุปกรณ์รองรับ

ดูรายการอุปกรณ์ปัจจุบันได้ที่ Google Store

ฉันจะให้ความคิดเห็นได้อย่างไร

เราให้ความสำคัญกับความคิดเห็นของคุณเป็นอย่างมาก เราขอแนะนำให้คุณแชร์ความคิดเห็นผ่านช่องทางการสนับสนุนของเรา ซึ่งแสดงอยู่ในหน้าการสนับสนุน

แม้ว่าเราจะพยายามอย่างเต็มที่เพื่อให้มั่นใจว่า API เหล่านี้จะรองรับการใช้งานของคุณได้เป็นอย่างดี แต่ Google Health API ก็ยังคงมีการพัฒนาอย่างต่อเนื่อง โปรดทราบว่าเราอาจทำการเปลี่ยนแปลงระหว่างตอนนี้จนถึงสิ้นเดือนพฤษภาคมตามความคิดเห็นของคุณ ซึ่งจะทำให้คุณต้องอัปเดตตามการเปลี่ยนแปลงดังกล่าว

แผนที่ถนน

รายการฟีเจอร์ที่จะเปิดตัวในปี 2026 มีดังนี้

ไตรมาส 4 ปี 2569

ประเภทข้อมูล (อ่านและเขียน)

  • อุณหภูมิผิวหนังแบบละเอียด
  • อัตราการเผาผลาญขณะพัก
  • เราจะเพิ่มประเภทข้อมูลเพื่อให้เทียบเท่ากับ Health Connect เราจะเพิ่มประเภทข้อมูล Health Connect อีกหลายประเภทในไตรมาสที่ 4 ปี 2026 และไตรมาสที่ 1 ปี 2027

ฟีเจอร์

  • เวอร์ชันเบต้าสำหรับผู้ใช้ทั่วไปเพื่อทดลองใช้ข้อมูลประเภทใหม่ๆ ก่อนเปิดตัว
  • ปลายทางสถิติเพื่อตรวจสอบการตรวจวัดระยะไกลของเว็บฮุค