Các API của Google Fit đã ngừng hoạt động và dự kiến sẽ ngừng cung cấp dịch vụ vào cuối năm 2026. Google cung cấp một số sản phẩm và dịch vụ về sức khoẻ thể chất và tinh thần để giúp người dùng tiếp tục đạt được mục tiêu sau khi ngừng hoạt động.
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 API Google Health để 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 sang dựa trên cách bạn đang sử dụng các API của Google Fit.
Đường dẫn 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 dữ liệu cụ thể.
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 số bước | Health Connect | Đọc dữ liệu tổng hợp về số bước từ nhiều nguồn, tập trung vào thiết bị di động. |
| Ứng dụng đồng hành với thiết bị theo dõi hoạt động thể dục | API Google Health | 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 khỏe và thể chất | API Google Health & Health Connect | Sử dụng API Google Health 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
| Chế độ tích hợp hiện tại | Đường dẫn được đề xuất | Phạm vi cung cấp |
|---|---|---|
| Google Fit (Android và API REST) | API Google Health | Có sẵn |
| Đọc số bước trên thiết bị di động (bằng API Bản ghi của Google Fit) | Health Connect | Có sẵn |
| API Fit trên Wear OS | Dịch vụ sức khỏe | Có sẵn |
| Fitbit Web API | API Google Health | Có sẵn |
| Recording API trên thiết bị di động | Health Connect | Có sẵn |
| Health Connect | Giữ nguyên chế độ tích hợp hiện có hoặc thêm API Google Health | Có sẵn |
So sánh kỹ thuật
Các phần sau đây cung cấp thông tin so sánh kỹ thuật giữa các API của Google Fit, API Google Health và Health Connect để giúp bạn chọn đường dẫn di chuyển phù hợp.
API Fit so với API Google Health
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) | API Google Health |
|---|---|---|
| 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 Google Health hợp nhất |
| Đăng ký ứng dụng | Tạo dự án trên Google Cloud | Tạo dự án trên Google Cloud và bật API Google Health |
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 | Yêu cầu OAuth 2.0 | Không yêu cầu OAuth (quyền trên thiết bị) |
| Lưu trữ dữ liệu | Tập trung vào đám mây | Tập trung vào thiết bị (trên thiết bị) |
| Đối tượng người xem | Nhà phát triển Android cũ | Nhà phát triển ứng dụng 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 của Google Fit. Nếu chế độ tích hợp của bạn cũng bao gồm các thành phần giao diện người dùng kết nối với ứng dụng Google Fit, hãy xem hướng dẫn về chế độ tích hợp ứng dụng Fit để biết thêm thông tin.
Các ứng dụng sử dụng API Bản ghi của Fit để ghi lại số bước
API bản ghi 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 thể chất hoặc nguồn dữ liệu cụ thể và 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ừ API Bản ghi của Fit:
| Điện thoại | Wear |
|
Sử dụng Dịch vụ sức khỏe:
Hãy xem tài liệu về Dịch vụ sức khỏe để biết thêm thông tin về sự khác biệt giữa hai dịch vụ này. |
Các ứng dụng sử dụng API Lịch sử để đọc hoặc ghi dữ liệu vào bộ nhớ các hoạt động thể dục
API Lịch sử 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ừ API Lịch sử:
| Điện thoại | Wear |
|
Không có. Dùng Health Connect trong ứng dụng dành cho thiết bị di động và không dành cho thiết bị đeo. |
Các ứng dụng sử dụng API Cảm biến để hiển thị dữ liệu thể chất theo thời gian thực
API Cảm biến 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ừ API Cảm biến:
| Điện thoại | Wear |
|
Sử dụng Dịch vụ sức khoẻ trên Wear OS:
|
Các ứng dụng sử dụng API Phiên để 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.
API phiên 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ừ API phiên:
| Đ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 API Google Health. |
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 dành cho thiết bị di động. Đối với những quy trình làm việc cụ thể, bạn nên làm như sau:
|
Các ứ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 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 API BLE
Ứ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.
Hãy làm theo các bước sau để di chuyển từ API BLE:
| Đ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:
- API Cảm biến: Sử dụng khung Cảm biến Android hoặc API Trình cung cấp vị trí kết hợp cho dữ liệu thô theo thời gian thực.
- API Mục tiêu: Không có API thay thế. Quản lý việc theo dõi mục tiêu và các mục tiêu hoạt động hằng ngày trong logic ứng dụng.
- API Bluetooth năng lượng thấp (BLE): Sử dụng trực tiếp các 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 API Google Health 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ì chế độ 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 hoạt động chế độ tích hợp ứng dụng Fit và các 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.
| checkLàm như sau | closeKhông làm như sau |
| Cung cấp Health Connect hoặc API Google Health làm lựa chọn mới trong ứng dụng của bạn.
Tập trung vào các lợi ích của người dùng 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 đến trải nghiệm tương tự cho người dùng mới của ứng dụng, bạn nên xây dựng chế độ tích hợp với Health Connect hoặc API Google Health.
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 đến trải nghiệm phong phú hơn cho người dùng, với dữ liệu được lưu trữ an toàn trên thiết bị. API Google Health 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.
| checkLàm như sau | closeKhông làm như sau |
| Đưa Health Connect hoặc API Google Health 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 có sẵn. |