Các API của Google Fit sẽ được hỗ trợ cho đến hết năm 2026. Google cung cấp một số sản phẩm và dịch vụ về sức khoẻ và thể chất để giúp người dùng tiếp tục đạt được mục tiêu sau khi chúng tôi ngừng cung cấp các sản phẩm và dịch vụ này.
Thận trọng: API Google Fit (bao gồm cả API REST) sẽ chỉ được hỗ trợ cho đến hết năm 2026. Bạn nên chuyển sang Google Health API để tích hợp dựa trên đám mây hoặc Health Connect để theo dõi số bước và các ứng dụng ưu tiên thiết bị di động.
Các nguyên tắc sau đây cho bạn biết dịch vụ nào cần di chuyển dựa trên cách bạn đang sử dụng API Google Fit.
Các phương pháp di chuyển được đề xuất
Bạn nên chọn API dựa trên loại ứng dụng và nhu cầu cụ thể về dữ liệu.
Theo loại ứng dụng
| Loại ứng dụng | Đường dẫn được đề xuất | Lý do chính |
|---|---|---|
| Ứng dụng theo dõi bước | Health Connect | Đọc dữ liệu tổng hợp về số bước từ nhiều nguồn trên thiết bị di động. |
| Ứng dụng đồng hành của thiết bị theo dõi hoạt động thể dục | Google Health API | Nền tảng tập trung vào web, yêu cầu OAuth để tích hợp người dùng. |
| Nền tảng Sức khoẻ và Thể chất | Google Health API và Health Connect | Sử dụng Google Health API cho dữ liệu thiết bị Fitbit/Google và Health Connect cho dữ liệu tổng hợp trên thiết bị. |
Theo chế độ tích hợp hiện tại
| Mục tích hợp hiện tại | Đường dẫn được đề xuất | Phạm vi cung cấp |
|---|---|---|
| Fit History API và Fit Session API | Google Health API | Có sẵn |
| Đọc số bước chân trên thiết bị di động (bằng Google Fit Recording API) | Health Connect | Có sẵn |
| API Fit trên Wear OS | Dịch vụ sức khỏe | Có sẵn |
| Fitbit Web API | Google Health API | Có sẵn |
| Health Connect | Duy trì chế độ tích hợp hiện có hoặc thêm Google Health API | Có sẵn |
So sánh về mặt kỹ thuật
Các phần sau đây cung cấp thông tin so sánh về mặt kỹ thuật giữa các API Google Fit, Google Health API và Health Connect để giúp bạn chọn đường dẫn di chuyển phù hợp.
API Fit so với Google Health API
Hãy sử dụng đường dẫn này nếu ứng dụng của bạn là một nền tảng dựa trên web hoặc yêu cầu các hoạt động tương tác từ máy chủ đến máy chủ (S2S).
| Tính năng | API Fit (Android/REST) | Google Health API |
|---|---|---|
| Thiết lập dự án | Bảng điều khiển Google Cloud | Tạo dự án trên Google Cloud |
| Cấu hình OAuth | Loại ứng dụng Android hoặc ứng dụng web | Loại ứng dụng web |
| Kiến trúc dữ liệu | Các loại có tiền tố com.google |
Các loại dữ liệu API hợp nhất của Google Health |
| Đăng ký ứng dụng | Tạo dự án trên Google Cloud | Tạo dự án trên Google Cloud và bật Google Health API |
API Fit so với Health Connect
Sử dụng đường dẫn này cho các ứng dụng Android ưu tiên thiết bị di động đọc các chỉ số của thiết bị cục bộ.
| Tính năng | API Fit cho Android | Health Connect |
|---|---|---|
| Đăng ký | Bảng điều khiển Google Cloud | Dự án trên Cửa hàng Play và nội dung khai báo ứng dụng sức khoẻ |
| Xác thực | Bắt buộc phải có OAuth 2.0 | Không cần OAuth (quyền trên thiết bị) |
| Lưu trữ dữ liệu | Tập trung vào đám mây | Lấy thiết bị làm trung tâm (trên thiết bị) |
| Độc giả | Nhà phát triển Android cũ | Nhà phát triển thiết bị di động Android hiện đại |
| Quyền | Phạm vi OAuth | Quyền trong tệp kê khai Android |
Tích hợp API Fit
Các phần sau đây cung cấp hướng dẫn về cách di chuyển từ từng API Google Fit. Nếu quá trình tích hợp của bạn cũng bao gồm các phần tử giao diện người dùng kết nối với ứng dụng Google Fit, hãy xem Nguyên tắc tích hợp ứng dụng Fit để biết thêm hướng dẫn.
Các ứng dụng sử dụng Fit Recording API để ghi lại số bước
Fit Recording API cho phép ứng dụng yêu cầu lưu trữ tự động dữ liệu cảm biến theo cách tiết kiệm pin bằng cách tạo đăng ký thuê bao.
Mỗi gói thuê bao kết nối một ứng dụng Android với một loại dữ liệu cụ thể về dữ liệu thể chất hoặc nguồn dữ liệu, đồng thời loại dữ liệu Step thường dùng để ghi lại số bước.
Hãy làm theo các bước sau để di chuyển từ Fit Recording API:
| Điện thoại | Wear |
|
Sử dụng Dịch vụ sức khoẻ:
Hãy xem tài liệu về Dịch vụ sức khoẻ để biết thêm thông tin về sự khác biệt giữa hai dịch vụ này. |
Ứng dụng sử dụng History API để đọc hoặc ghi dữ liệu vào bộ nhớ các hoạt động thể dục
History API cho phép ứng dụng thực hiện hàng loạt thao tác trên bộ nhớ các hoạt động thể dục. Các thao tác này bao gồm đọc, chèn, cập nhật và xoá dữ liệu lịch sử về sức khoẻ và thể chất.
Hãy làm theo các bước sau để di chuyển từ History API:
| Điện thoại | Wear |
|
Không có. Dùng Health Connect trong ứng dụng di động và không dành cho thiết bị đeo. |
Ứng dụng sử dụng Sensor API để hiển thị dữ liệu thể chất theo thời gian thực
Sensor API cho phép bạn đọc dữ liệu cảm biến thô trong ứng dụng theo thời gian thực. API Cảm biến có chức năng sau:
- Liệt kê các nguồn dữ liệu có trên thiết bị và trên các thiết bị đồng hành.
- Đăng ký trình nghe để nhận dữ liệu cảm biến thô.
- Hủy đăng ký trình nghe để nó không còn nhận được dữ liệu cảm biến thô.
Hãy làm theo các bước sau để di chuyển từ Sensor API:
| Điện thoại | Wear |
|
Sử dụng Dịch vụ sức khoẻ trên Wear OS:
|
Ứng dụng dùng Session API để cung cấp thông tin tóm tắt về hoạt động
Phiên hoạt động biểu thị khoảng thời gian người dùng thực hiện một hoạt động thể chất.
Session API cho phép ứng dụng tạo phiên trong bộ nhớ các hoạt động thể chất.
Hãy làm theo các bước sau để di chuyển từ Session API:
| Điện thoại | Wear |
|
Bắt đầu/dừng: Không áp dụng. Ứng dụng này phải theo dõi trạng thái của các phiên đang diễn ra bên trong. Đọc/ghi: Chuyển sang Google Health API. |
Bắt đầu/dừng: Sử dụng Dịch vụ sức khỏe (ExerciseClient) Đọc/ghi: Sử dụng Health Connect với ứng dụng di động. Đối với những quy trình làm việc cụ thể, bạn nên làm như sau:
|
Ứng dụng sử dụng API Mục tiêu
Mục tiêu là các đích cần thực hiện trong ứng dụng Google Fit người dùng có thể tự đặt cho các chỉ số của mình, chẳng hạn như số bước và điểm nhịp tim. Nền tảng Fit ghi lại mục tiêu và theo dõi hoạt động hằng ngày của họ so với các mục tiêu đó bằng cách sử dụng API mục tiêu.
| Điện thoại | Wear |
| Không có API thay thế. | Không có API thay thế. |
Các ứng dụng sử dụng BLE API
Ứng dụng của bạn có thể tìm các thiết bị Bluetooth năng lượng thấp (BLE) và chèn dữ liệu cảm biến vào nền tảng Google Fit bằng API BLE.
Làm theo các bước sau để di chuyển từ BLE API:
| Điện thoại | Wear |
| Sử dụng trực tiếp API Android Bluetooth. | Sử dụng trực tiếp API Android Bluetooth. |
Tính năng không được dùng nữa
Các tính năng sau đây không có API thay thế trực tiếp. Sử dụng các API tiêu chuẩn được đề xuất của Android:
- Sensor API: Sử dụng khung Android Sensors hoặc Fused Location Provider API để lấy dữ liệu thô theo thời gian thực.
- Goals API: Không có API thay thế. Quản lý tính năng theo dõi mục tiêu và mục tiêu hoạt động hằng ngày trong logic ứng dụng của bạn.
- API Bluetooth năng lượng thấp (BLE): Sử dụng trực tiếp API Android Bluetooth để giao tiếp với phần cứng.
Tích hợp ứng dụng Fit
Nếu ứng dụng của bạn kết nối với Google Fit để chia sẻ dữ liệu, hãy làm theo hướng dẫn về cách di chuyển người dùng hiện tại và người dùng mới sang Health Connect hoặc Google Health API trong các phần sau:
Người dùng hiện tại của ứng dụng
Nếu giao diện người dùng của ứng dụng có cách để người dùng kết nối với Google Fit (hoặc nếu ứng dụng của bạn có trong danh sách Các ứng dụng hoạt động với Google Fit), bạn có thể tiếp tục duy trì việc tích hợp ứng dụng Fit cho người dùng hiện tại.
Chúng tôi sẽ cập nhật thông tin trong phần này về thời điểm ngừng cung cấp tính năng tích hợp ứng dụng Fit và những lựa chọn tốt nhất để duy trì trải nghiệm người dùng. Trong thời gian chờ đợi, bạn có thể liên hệ với chúng tôi.
| checkDo this | đóngKhông nên làm việc này |
| Cung cấp Health Connect hoặc Google Health API làm lựa chọn mới trong ứng dụng của bạn.
Tập trung vào lợi ích của người dùng, chẳng hạn như dữ liệu và thông tin chi tiết phong phú hơn, quyền riêng tư và tính bảo mật.
|
Yêu cầu người dùng ngắt kết nối với Google Fit.
|
Người dùng mới của ứng dụng
Để mang lại trải nghiệm tương tự cho người dùng mới của ứng dụng, bạn nên tạo mối liên kết tích hợp với Health Connect hoặc Google Health API.
Health Connect cung cấp quyền truy cập vào các nguồn và loại dữ liệu mới để mang lại trải nghiệm phong phú hơn cho người dùng, đồng thời dữ liệu được lưu trữ an toàn trên thiết bị. Google Health API cung cấp một nền tảng tập trung vào web cho dữ liệu trên thiết bị Fitbit và Google.
| checkDo this | đóngKhông nên làm việc này |
| Thêm Health Connect hoặc Google Health API vào quy trình thiết lập của ứng dụng. | Cung cấp Fit dưới dạng một ứng dụng mà người dùng có thể kết nối sau khi Health Connect ra mắt. |