API Google Fit, bao gồm cả API Google Fit REST, sẽ ngừng hoạt động sau ngày 30 tháng 6 năm 2025. Kể từ ngày 1 tháng 5 năm 2024, nhà phát triển không thể đăng ký sử dụng các API này.
Hướng dẫn này giải thích cách bắt đầu phát triển bằng Google Fit trên Android.
Thiết lập
Trước khi bắt đầu tạo ứng dụng, hãy hoàn thành các bước trong các phần sau.
Tạo tài khoản Google
Để sử dụng API Google Fit, bạn cần có Tài khoản Google. Bạn có thể tạo tài khoản mới hoặc sử dụng tài khoản hiện có. Bạn nên tạo một tài khoản riêng để kiểm thử ứng dụng từ góc độ người dùng.
Tải Dịch vụ Google Play
Tải thư viện ứng dụng mới nhất cho Dịch vụ Google Play trên máy chủ phát triển:
Bạn nên sử dụng môi trường phát triển Android Studio để tạo ứng dụng bằng API Fitness. Để biết thông tin chi tiết về cách tạo một dự án mới và định cấu hình dự án đó trong Android Studio, hãy xem phần Tạo dự án.
Thêm thư viện ứng dụng Dịch vụ Google Play
Trong Android Studio, hãy mở tệp build.gradle cho mô-đun của bạn rồi thêm thư viện ứng dụng Dịch vụ Google Play làm phần phụ thuộc:
Điều này giúp đảm bảo rằng Gradle sẽ tự động tải SDK thể dục xuống khi tạo ứng dụng.
Tạo và kiểm thử ứng dụng
Sau khi hoàn tất các bước thiết lập, bạn có thể bắt đầu tạo ứng dụng. Để bắt đầu, hãy tìm hiểu về các loại dữ liệu mà ứng dụng của bạn có thể lưu trữ và đọc. Tìm hiểu thêm về cách xử lý dữ liệu trong Google Fit.
Các loại dữ liệu mà ứng dụng của bạn có quyền truy cập tương ứng với phạm vi uỷ quyền. Để yêu cầu các quyền này, bạn cần thêm loại dữ liệu mà ứng dụng của bạn cần truy cập trong một thực thể FitnessOptions. Khi ứng dụng của bạn yêu cầu sử dụng bất kỳ loại dữ liệu Google Fit nào, SDK Android sẽ tự động kiểm tra xem các loại dữ liệu đó thuộc phạm vi nào và yêu cầu người dùng cấp quyền truy cập vào các phạm vi đó.
Tạo ứng dụng API
Tạo một ứng dụng khách API và thêm các loại dữ liệu mà ứng dụng của bạn cần truy cập để ghi hoặc đọc dữ liệu. Có các điểm cuối sau:
SensorsClient: Truy cập vào nhiều nguồn dữ liệu sức khoẻ và chăm sóc sức khoẻ tinh thần từ các cảm biến phần cứng trong thiết bị cục bộ và trong thiết bị đồng hành.
RecordingClient: Để thu thập dữ liệu cảm biến ở chế độ tiết kiệm pin, luôn bật ở chế độ nền.
HistoryClient: Chèn, xoá và đọc dữ liệu trong quá khứ trong Google Fit.
Sau đây là luồng uỷ quyền mà người dùng trải nghiệm khi được yêu cầu cấp quyền:
Hình 1.Luồng uỷ quyền cho người dùng.
Quyền trên Android: Người dùng sẽ thấy những quyền trên Android mà ứng dụng của bạn đã yêu cầu trước khi tải ứng dụng xuống. Sau khi được tải xuống, ứng dụng sẽ yêu cầu mọi quyền khi bắt đầu chạy mà ứng dụng cần, và người dùng sẽ cấp hoặc từ chối các quyền này.
Kiểm tra và kết nối: Ứng dụng của bạn sẽ kiểm tra xem các quyền có được cấp hay không trước khi yêu cầu quyền truy cập vào các loại dữ liệu khác.
Yêu cầu cấp phạm vi OAuth: Google nhắc người dùng cấp cho ứng dụng của bạn các phạm vi OAuth cần thiết cho các loại dữ liệu mà ứng dụng muốn truy cập.
Quyền truy cập đã được áp dụng: Sau khi người dùng cấp quyền, ứng dụng của bạn có thể truy cập vào các loại dữ liệu thuộc phạm vi mà người dùng đã cấp quyền.
[null,null,["Cập nhật lần gần đây nhất: 2025-03-11 UTC."],[[["This guide provides instructions for Android developers to integrate Google Fit into their applications."],["It outlines the necessary setup steps, including obtaining a Google account, setting up Google Play services, and acquiring OAuth 2.0 client ID."],["Developers are guided through the process of creating an API client and implementing data access functionalities."],["Before publishing, developers need to apply for verification to ensure data security and compliance."],["The guide also explains the authorization flow users will experience when granting data access permissions to the app."]]],[]]