API Fitbit Web đã được cải thiện và hiện đại hoá để cung cấp một nền tảng chuẩn hoá, nhất quán và có thể mở rộng hơn cho việc tích hợp của nhà phát triển, và hiện được gọi là API Google Health. Google Health API là bước tiến chiến lược của Fitbit Web API cũ, được xây dựng lại từ đầu trên cơ sở hạ tầng hiện đại của Google.
Với nền tảng này, nhà phát triển có thể khai thác toàn bộ sức mạnh của bộ công cụ cho nhà phát triển trên Google Cloud, đồng thời mang đến cho người dùng một phương thức quen thuộc và đơn giản để quản lý quyền thông qua Google OAuth 2.0.
Bạn nhận được gì khi dùng Google Health API?
- Nguồn đáng tin cậy hợp nhất: "Luồng dữ liệu đã đối chiếu" mới của chúng tôi xử lý nhiệm vụ phức tạp là đối chiếu các điểm dữ liệu trùng lặp từ nhiều nguồn. Điều này đảm bảo các ứng dụng hiển thị cùng một dữ liệu nhất quán mà người dùng thấy trong ứng dụng Fitbit. Luồng này sẽ được cung cấp cùng với luồng của bên thứ nhất bao gồm dữ liệu từ các thiết bị Fitbit và Pixel, cũng như các mục nhập thủ công.
- Hiện đại hoá kỹ thuật và hiệu suất: Chúng tôi đã hợp nhất hơn 100 điểm cuối cũ thành một tập hợp các gói kiểu dữ liệu đơn giản và hợp lý, đồng thời loại bỏ sự không nhất quán trong định dạng dữ liệu, múi giờ, đơn vị đo lường và cách xử lý lỗi. Hơn nữa, chúng tôi hiện hỗ trợ giao thức HTTP/REST để truy xuất dữ liệu hiệu suất cao. Ngoài ra, dữ liệu trong ngày và webhook hiện đã có sẵn cho tất cả các loại dữ liệu có liên quan thông qua một điểm cuối danh sách chuyên dụng.
- Webhook nâng cao và khả năng mở rộng: Hưởng lợi từ khả năng hỗ trợ webhook mở rộng, bao gồm cả tính năng tự động đăng ký và quản lý chi tiết cho tất cả các loại dữ liệu có liên quan, được thiết kế để mở rộng quy mô với thế hệ ứng dụng sức khoẻ dựa trên AI tiếp theo.
- Danh tính và bảo mật hợp lý: Thay thế cơ chế uỷ quyền cũ của Fitbit (FOT) bằng Google OAuth 2.0. Điều này cho phép nhà phát triển sử dụng các thư viện xác thực tiêu chuẩn của Google, đơn giản hoá toàn bộ mã nguồn, đồng thời cung cấp cho người dùng một cách quen thuộc và tập trung để quản lý quyền của họ. Tất cả phạm vi của API Google Health đều được phân loại là Bị hạn chế, cần phải xem xét quyền riêng tư và bảo mật để có quyền truy cập.
Bạn thích thành phần mà bạn thấy trên màn hình? Bắt đầu ngay!
Các phiên bản API và kênh thử nghiệm công khai
API Google Health sử dụng tính năng tạo phiên bản dựa trên kênh theo Đề xuất cải tiến API (AIP) của Google, cụ thể là AIP-185: Tạo phiên bản API và AIP-181: Mức độ ổn định. API này được cung cấp trên hai kênh công khai: kênh v4 ổn định và kênh v4beta thử nghiệm công khai. Google hỗ trợ cả hai kênh thông qua kênh hỗ trợ tiêu chuẩn.
So sánh kênh ổn định và kênh thử nghiệm beta
Theo AIP-185, kênh v4beta đóng vai trò là một tập hợp lớn của kênh v4 ổn định. Phiên bản này bao gồm
tất cả chức năng ổn định của v4 cùng với các loại dữ liệu, trường và
phương thức truy cập sớm đang được đối tác thử nghiệm.
Trong tài liệu, các phần tử API chỉ có trong kênh thử nghiệm beta sẽ hiển thị nhãn v4beta.
| Tính năng | Kênh ổn định (v4) |
Kênh thử nghiệm công khai (v4beta) |
|---|---|---|
| URI cơ sở REST | https://health.googleapis.com/v4 |
https://health.googleapis.com/v4beta |
| gói gRPC | google.devicesandservices.health.v4 |
google.devicesandservices.health.v4beta |
| Tài liệu tham khảo | v4 REST và v4 RPC | v4beta REST và v4beta RPC |
| Mức độ ổn định | Sẵn sàng cho môi trường thực tế và chịu sự điều chỉnh của quy tắc tương thích ngược AIP-180. | Bản xem trước không ổn định có thể bị thay đổi hoặc xoá bất cứ lúc nào mà không cần thông báo. |
| Mục đích sử dụng | Ứng dụng sản xuất trực tiếp, dành cho người dùng. | Thử nghiệm sớm, tạo nguyên mẫu, xác thực giản đồ và thu thập ý kiến phản hồi của nhà phát triển. |
| Hỗ trợ | Được hỗ trợ thông qua các kênh hỗ trợ tiêu chuẩn. | Được hỗ trợ thông qua kênh hỗ trợ tiêu chuẩn để báo cáo lỗi, khắc phục sự cố và đưa ra ý kiến phản hồi về thiết kế. |
Cách xử lý kênh v4beta
Khi khám phá các chức năng được gắn thẻ v4beta, hãy làm theo các nguyên tắc sau:
- Sử dụng
v4betachủ yếu trong môi trường phát triển, thử nghiệm và không phát hành chính thức. Bạn không nên cung cấp các tính năng chính thức phụ thuộc vào các điểm cuốiv4betahoặc các loại dữ liệu chỉ có trong phiên bản thử nghiệm. - Giản đồ, tên trường, hành vi của điểm cuối và cách trình bày dữ liệu trong
v4betacó thể thay đổi mà không cần thông báo trước. Các tính năng và loại dữ liệu thử nghiệm cũng có thể bị xoá hoàn toàn nếu không đáp ứng các mục tiêu xác thực. - Tách riêng mã ứng dụng
v4betathử nghiệm bằng cờ tính năng hoặc các mô-đun riêng biệt để những thay đổi có thể gây lỗi trong kênh thử nghiệm beta không làm gián đoạn quá trình tích hợpv4chính. - Nhận hỗ trợ, báo cáo vấn đề và chia sẻ ý kiến phản hồi về việc triển khai
v4betathông qua các kênh hỗ trợ tiêu chuẩn của chúng tôi để giúp định hình thiết kế API cuối cùng.
Chuyển từ phiên bản beta 4 lên phiên bản ổn định 4
Các loại dữ liệu và tính năng mới sẽ được đưa vào v4beta để hỗ trợ đối tác thử nghiệm và xác thực thị trường trước khi chuyển sang kênh v4 ổn định.
Google đánh giá các tính năng thử nghiệm dựa trên các tiêu chí sau trước khi đưa các tính năng đó vào v4:
- Quá trình thử nghiệm của đối tác xác nhận rằng mô hình dữ liệu, ngữ nghĩa trường và mẫu truy vấn đáp ứng các yêu cầu của ứng dụng trong thực tế.
- Ý kiến phản hồi của nhà phát triển và quy trình xem xét thiết kế đã hoàn tất, đồng thời giản đồ đã sẵn sàng để khoá theo cam kết đảm bảo khả năng tương thích ngược của AIP-180.
- Quy trình dữ liệu hai đầu, đồng bộ hoá thiết bị và độ tin cậy của dịch vụ đáp ứng các tiêu chuẩn chất lượng sản xuất.
- Theo quy tắc ngừng sử dụng AIP-185, mọi trường hoặc hành vi không còn được dùng trong quá trình thử nghiệm beta sẽ bị xoá thay vì được chuyển sang
v4.
Mặc dù AIP-181 đưa ra quy tắc chung là khoảng 90 ngày để đánh giá bản thử nghiệm, nhưng thời gian thực tế để nâng cấp một tính năng từ v4beta lên v4 phụ thuộc vào độ phức tạp của tính năng, khả năng cung cấp phần cứng và ý kiến phản hồi xác thực. Một số tính năng có thể
được phát hành chính thức sớm hơn, trong khi một số tính năng khác có thể vẫn ở giai đoạn v4beta lâu hơn hoặc bị ngừng cung cấp.
Khi một kiểu dữ liệu hoặc tính năng được chuyển sang kênh v4 ổn định, Google sẽ thông báo về việc chuyển đổi này trong Ghi chú phát hành. Tại thời điểm đó, hãy cập nhật các yêu cầu của bạn từ https://health.googleapis.com/v4beta thành https://health.googleapis.com/v4 trước khi phát hành bản tích hợp cho người dùng chính thức.
Còn API Fitbit Web thì sao?
Fitbit Web API cũ đã ngừng hoạt động theo tiến trình sau:
- Ngày 30 tháng 9 năm 2026 (Ngừng hỗ trợ): Ngừng hỗ trợ Fitbit Web API và Google ngừng sửa lỗi hoặc hỗ trợ API.
- Ngày 2 tháng 11 năm 2026 (Ngừng cung cấp API): Fitbit Web API và các điểm cuối Fitbit OAuth đã ngừng hoạt động và không còn chức năng hoặc đồng bộ hoá dữ liệu đến hoặc từ người dùng Google Health. Yêu cầu đến các điểm cuối này không thành công và trả về mã trạng thái HTTP
410 Gone.
Nhà phát triển sử dụng Fitbit Web API và Fitbit Authorization cũ nên di chuyển ứng dụng và người dùng sang Google Health API và Google OAuth 2.0.
Xem hướng dẫn di chuyển để bắt đầu.
Những thiết bị nào được hỗ trợ?
Tất cả thiết bị Fitbit và đồng hồ Google Pixel, cả hiện tại và trước đây, sẽ thu thập dữ liệu được trả về thông qua API Google Health. Loại dữ liệu có sẵn sẽ phụ thuộc vào chức năng mà thiết bị hỗ trợ.
Bạn có thể xem danh sách các thiết bị hiện có trên Google Store.
Làm cách nào để tôi trao ý kiến phản hồi?
Chúng tôi rất trân trọng ý kiến phản hồi của bạn. Bạn nên chia sẻ ý kiến của mình thông qua các kênh hỗ trợ của chúng tôi, được liệt kê trên trang Hỗ trợ.
Mặc dù chúng tôi đã nỗ lực hết sức để đảm bảo các API này hỗ trợ bạn hiệu quả, nhưng API Google Health vẫn đang trong quá trình phát triển. Xin lưu ý rằng dựa trên ý kiến phản hồi của bạn, chúng tôi có thể đưa ra những thay đổi từ nay đến cuối tháng 5, đòi hỏi bạn phải cập nhật tương ứng.
Lộ trình
Sau đây là danh sách các tính năng sẽ ra mắt vào năm 2026.
Quý 4 năm 2026
Loại dữ liệu (đọc và ghi)
- Nhiệt độ trên da chi tiết
- Tỷ lệ trao đổi chất cơ bản
- Chúng tôi sẽ bổ sung các loại dữ liệu để đạt được sự tương đồng với Health Connect. Bạn có thể mong đợi nhiều loại dữ liệu Health Connect khác sẽ được thêm vào quý 4 năm 2026 và quý 1 năm 2027.
Tính năng
- Kênh thử nghiệm công khai để tiếp cận sớm các loại dữ liệu mới
- Điểm cuối thống kê để theo dõi dữ liệu đo từ xa của webhook