คำแนะนำในการย้ายข้อมูลจาก Fit

เราจะรองรับ Google Fit API จนถึงสิ้นปี 2026 Google มีผลิตภัณฑ์และบริการด้านสุขภาพและความแข็งแรงสมบูรณ์มากมายที่จะช่วยให้ผู้ใช้บรรลุเป้าหมายต่อไปได้หลังจากการเลิกใช้งาน

ข้อควรระวัง: เราจะรองรับ Google Fit API (รวมถึง REST API) จนถึงสิ้นปี 2026 เท่านั้น เราขอแนะนำให้ย้ายข้อมูลไปยัง Google Health API สำหรับการผสานรวมที่อิงตามระบบคลาวด์ หรือ Health Connect สำหรับการติดตามจำนวนก้าวและแอปที่เน้นการใช้งานบนอุปกรณ์เคลื่อนที่เป็นหลัก

หลักเกณฑ์ต่อไปนี้จะแสดงบริการที่คุณควรย้ายข้อมูลไปตามวิธีที่คุณใช้ Google Fit API

เส้นทางการย้ายข้อมูลที่แนะนำ

คุณควรเลือก API ตามประเภทแอปพลิเคชันและความต้องการข้อมูลที่เฉพาะเจาะจง

ตามประเภทแอปพลิเคชัน

ประเภทแอปพลิเคชัน	เส้นทางที่แนะนำ	เหตุผลหลัก
แอปติดตามจำนวนก้าว	Health Connect	การอ่านข้อมูลจำนวนก้าวที่รวบรวมจากแหล่งต่างๆ ซึ่งเน้นการใช้งานบนอุปกรณ์เคลื่อนที่เป็นหลัก
แอปคู่หูของเครื่องติดตามการเคลื่อนไหว	Google Health API	แพลตฟอร์มที่เน้นการใช้งานบนเว็บซึ่งต้องใช้ OAuth สำหรับการผสานรวมผู้ใช้
แพลตฟอร์มด้านสุขภาพและการออกกำลังกาย	Google Health API และ Health Connect	ใช้ Google Health API สำหรับข้อมูลอุปกรณ์ Fitbit/Google และใช้ Health Connect สำหรับข้อมูลที่รวบรวมในอุปกรณ์

ตามการผสานรวมปัจจุบัน

การผสานรวมปัจจุบัน	เส้นทางที่แนะนำ	ความพร้อมใช้งาน
Fit History API และ Fit Session API	Google Health API	พร้อมใช้งาน
การอ่านจำนวนก้าวบนอุปกรณ์เคลื่อนที่ (ด้วย Google Fit Recording API)	Health Connect	พร้อมใช้งาน
Fit API บน Wear OS	บริการข้อมูลสุขภาพ	พร้อมใช้งาน
Fitbit Web API	Google Health API	พร้อมใช้งาน
Health Connect	ใช้การผสานรวมที่มีอยู่ต่อไปหรือเพิ่ม Google Health API	พร้อมใช้งาน

การเปรียบเทียบทางเทคนิค

ส่วนต่อไปนี้จะเปรียบเทียบทางเทคนิคระหว่าง Google Fit API, Google Health API และ Health Connect เพื่อช่วยคุณเลือกเส้นทางการย้ายข้อมูลที่เหมาะสม

Fit API กับ Google Health API

ใช้เส้นทางนี้หากแอปของคุณเป็นแพลตฟอร์มที่อิงตามเว็บหรือต้องมีการโต้ตอบแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์ (S2S)

ฟีเจอร์	Fit API (Android/REST)	Google Health API
การตั้งค่าโปรเจ็กต์	Google Cloud Console	สร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google
การกำหนดค่า OAuth	ประเภทแอปพลิเคชัน Android หรือเว็บแอปพลิเคชัน	ประเภทเว็บแอปพลิเคชัน
สถาปัตยกรรมข้อมูล	ประเภทที่ขึ้นต้นด้วย com.google	ประเภทข้อมูล Google Health API ที่รวมเป็นหนึ่งเดียว
การลงทะเบียนแอป	สร้างโปรเจ็กต์ Google Cloud	สร้างโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google และเปิดใช้ Google Health API

Fit API กับ Health Connect

ใช้เส้นทางนี้สำหรับแอปพลิเคชัน Android ที่เน้นการใช้งานบนอุปกรณ์เคลื่อนที่เป็นหลักซึ่งอ่านเมตริกของอุปกรณ์ในเครื่อง

ฟีเจอร์	Fit API สำหรับ Android	Health Connect
การลงทะเบียน	Google Cloud Console	โปรเจ็กต์ Play Store และการประกาศเกี่ยวกับแอปสุขภาพ
การตรวจสอบสิทธิ์	ต้องใช้ OAuth 2.0	ไม่จำเป็นต้องใช้ OAuth (สิทธิ์ในอุปกรณ์)
การจัดเก็บข้อมูล	เน้นการใช้งานบนระบบคลาวด์เป็นหลัก	เน้นการใช้งานบนอุปกรณ์เป็นหลัก (ในอุปกรณ์)
กลุ่มเป้าหมาย	นักพัฒนาแอป Android แบบเดิม	นักพัฒนาแอป Android บนอุปกรณ์เคลื่อนที่สมัยใหม่
สิทธิ์	ขอบเขต OAuth	สิทธิ์ในไฟล์ Manifest ของ Android

การผสานรวม Fit API

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

แอปที่ใช้ Fit Recording API สำหรับบันทึกจำนวนก้าว

Fit Recording API ช่วยให้แอปขอจัดเก็บข้อมูลเซ็นเซอร์โดยอัตโนมัติ ได้อย่างประหยัดแบตเตอรี่ด้วยการสร้างการสมัครใช้บริการ การสมัครใช้บริการแต่ละรายการจะเชื่อมต่อแอป Android กับข้อมูลประเภทใดประเภทหนึ่งหรือแหล่งข้อมูลการออกกำลังกาย และข้อมูลประเภท Step มักใช้กันโดยทั่วไปสำหรับการบันทึกจำนวนก้าว

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลจาก Fit Recording API

ตารางที่ 1: ขั้นตอนการย้ายข้อมูลจาก Fit Recording API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
หากต้องการแสดงจำนวนก้าวทั้งหมด ให้เพิ่ม Health Connect ลงในแอป จำนวนก้าวทั้งหมดจะรวม จำนวนก้าวจากอุปกรณ์เคลื่อนที่ (Android 14 ขึ้นไป) และจำนวนก้าวจากแอปและ อุปกรณ์อื่นๆ หากต้องการแสดงข้อมูลจำนวนก้าวในเครื่องต่อไปในแอป ให้ใช้ API การเขียนของ Health Connect เพื่อเขียนข้อมูล โดยใช้ API การเขียนของ Health Connect	ใช้บริการข้อมูลสุขภาพดังนี้ PassiveMonitoringClient ExerciseClient ดูข้อมูลเพิ่มเติมเกี่ยวกับความแตกต่างระหว่างทั้ง 2 รายการได้ในเอกสารประกอบของบริการข้อมูลสุขภาพ

แอปที่ใช้ History API เพื่ออ่านหรือเขียนข้อมูลลงในที่เก็บข้อมูลการออกกำลังกาย

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

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลจาก History API

ตารางที่ 2: ขั้นตอนการย้ายข้อมูลจาก Fit History API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
เปลี่ยนไปใช้ Google Health API	ไม่เกี่ยวข้อง ใช้ Health Connect จากแอปบนอุปกรณ์เคลื่อนที่ ไม่ใช่อุปกรณ์ที่สวมใส่ได้

แอปที่ใช้ Sensor API เพื่อแสดงข้อมูลการออกกำลังกายแบบเรียลไทม์

Sensor API ช่วยให้คุณอ่านข้อมูลเซ็นเซอร์ดิบในแอปได้แบบเรียล ไทม์ Sensor API มีหน้าที่ดังนี้

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

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลจาก Sensor API

ตารางที่ 3: ขั้นตอนการย้ายข้อมูลจาก Fit Sensor API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
ใช้ เซ็นเซอร์, ผู้ให้บริการ Fused Location API	ใช้บริการข้อมูลสุขภาพ ใน Wear OS ดังนี้ PassiveMonitoringClient MeasureClient ExerciseClient หรือใช้ SensorManager, FusedLocationProvider

แอปที่ใช้ Session API เพื่อแสดงข้อมูลสรุปกิจกรรม

เซสชันแสดงช่วงเวลาที่ผู้ใช้ทำกิจกรรมการออกกำลังกาย

Session API ช่วยให้แอปสร้างเซสชันในที่เก็บข้อมูลการออกกำลังกาย ได้

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลจาก Session API

ตารางที่ 4: ขั้นตอนการย้ายข้อมูลจาก Fit Session API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
เริ่ม/หยุด: ไม่เกี่ยวข้อง แอปพลิเคชันควรติดตามสถานะของเซสชันที่กำลังดำเนินอยู่ภายใน อ่าน/เขียน: เปลี่ยนไปใช้ Google Health API	เริ่ม/หยุด: ใช้บริการข้อมูลสุขภาพ (ExerciseClient) อ่าน/เขียน: ใช้ Health Connect กับแอปบนอุปกรณ์เคลื่อนที่ สำหรับเวิร์กโฟลว์ที่เฉพาะเจาะจง เราขอแนะนำดังนี้ การแทรกเซสชัน: นักพัฒนาแอปควรใช้ Health Connect กับ แอปบนอุปกรณ์เคลื่อนที่ และแทรก ExerciseSessionRecord หรือ SleepSessionRecord ตามความเหมาะสม

แอปที่ใช้ Goals API

เป้าหมายคือเป้าหมายในแอป Google Fit ที่ผู้ใช้ตั้งค่าสำหรับเมตริกต่างๆ เช่น จำนวนก้าวและคะแนนคาร์ดิโอ แพลตฟอร์ม Fit จะบันทึกเป้าหมายและติดตาม กิจกรรมประจำวันของผู้ใช้เทียบกับเป้าหมายเหล่านี้โดยใช้ Goals API

ตารางที่ 5: คำแนะนำในการย้ายข้อมูลสำหรับ Fit Goals API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
ไม่มี API ที่จะมาแทนที่	ไม่มี API ที่จะมาแทนที่

แอปที่ใช้ BLE API

แอปของคุณสามารถค้นหาอุปกรณ์บลูทูธพลังงานต่ำ (BLE) ที่พร้อมใช้งานและแทรก ข้อมูลเซ็นเซอร์ลงในแพลตฟอร์ม Google Fit ได้โดยใช้ BLE API

ทำตามขั้นตอนต่อไปนี้เพื่อย้ายข้อมูลจาก BLE API

ตารางที่ 6: ขั้นตอนการย้ายข้อมูลจาก Fit BLE API

โทรศัพท์	อุปกรณ์ที่สวมใส่ได้
ใช้ Android Bluetooth API โดยตรง	ใช้ Android Bluetooth API โดยตรง

ฟีเจอร์ที่เลิกใช้งาน

ฟีเจอร์ต่อไปนี้ไม่มี API ที่จะมาแทนที่โดยตรง ใช้ API มาตรฐานที่แนะนำของ Android ดังนี้

• Sensor API: ใช้เฟรมเวิร์กเซ็นเซอร์ของ Android หรือ Fused Location Provider API สำหรับข้อมูลดิบแบบเรียลไทม์
• Goals API: ไม่มี API ที่จะมาแทนที่ จัดการการติดตามเป้าหมายและเป้าหมายกิจกรรมประจำวันภายในตรรกะของแอปพลิเคชัน
• Bluetooth Low Energy (BLE) API: ใช้ Android Bluetooth API โดยตรงเพื่อ สื่อสารกับฮาร์ดแวร์

การผสานรวมแอป Fit

หากแอปของคุณเชื่อมต่อกับ Google Fit เพื่อแชร์ข้อมูล ให้ทำตามคำแนะนำในการย้ายข้อมูลผู้ใช้ที่มีอยู่และผู้ใช้ใหม่ไปยัง Health Connect หรือ Google Health API ในส่วนต่อไปนี้

ผู้ใช้ที่มีอยู่ของแอป

หาก UI ของแอปมีวิธีให้ผู้ใช้เชื่อมต่อกับ Google Fit (หรือหากแอปของคุณรวมอยู่ในรายการแอปที่ทำงานร่วมกับ Google Fit) คุณสามารถดูแลการผสานรวมแอป Fit สำหรับผู้ใช้ปัจจุบันต่อไปได้

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

ตารางที่ 7: คำแนะนำสำหรับผู้ใช้ที่มีอยู่ซึ่งมีการผสานรวมแอป Fit

checkสิ่งที่ควรทำ	closeสิ่งที่ไม่ควรทำ
เสนอ Health Connect หรือ Google Health API เป็นตัวเลือกใหม่ในแอป มุ่งเน้นที่ประโยชน์ของผู้ใช้ เช่น ข้อมูลและข้อมูลเชิงลึกที่ละเอียดยิ่งขึ้น ความเป็นส่วนตัว และ ความปลอดภัย	ขอให้ผู้ใช้ยกเลิกการเชื่อมต่อจาก Google Fit

ผู้ใช้ใหม่ของแอป

หากต้องการมอบประสบการณ์ที่คล้ายคลึงกันให้กับผู้ใช้ใหม่ของแอป เราขอแนะนำให้ สร้างการผสานรวมกับ Health Connect หรือ Google Health API

Health Connect ช่วยให้เข้าถึงแหล่งข้อมูลและประเภทข้อมูลใหม่ๆ เพื่อมอบประสบการณ์ที่ละเอียดยิ่งขึ้นแก่ผู้ใช้ โดยข้อมูลจะจัดเก็บไว้อย่างปลอดภัยในอุปกรณ์ Google Health API เป็นแพลตฟอร์มที่เน้นการใช้งานบนเว็บสำหรับข้อมูลอุปกรณ์ Fitbit และ Google

ตารางที่ 8: คำแนะนำสำหรับผู้ใช้ใหม่ซึ่งมีการผสานรวมแอป Fit

checkสิ่งที่ควรทำ	closeสิ่งที่ไม่ควรทำ
รวม Health Connect หรือ Google Health API ไว้ในขั้นตอนการตั้งค่าของแอป	เสนอ Fit เป็นแอปที่ผู้ใช้เชื่อมต่อได้เมื่อ Health Connect พร้อมใช้งาน