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.

Để biết hướng dẫn về API hoặc nền tảng mà bạn muốn di chuyển sang, hãy truy cập vào Hướng dẫn di chuyển của Health Connect. Để so sánh Health Connect với API Google Fit và API Fitbit Web, hãy xem phần hướng dẫn so sánh Health Connect.

Tìm hiểu thêm về Health Connect và cách tích hợp với API này.

Trang này được dịch bởi Cloud Translation API.

Nhận mã ứng dụng khách OAuth 2.0

Tổng quan

Để sử dụng Google Fit dành cho Android, bạn cần có ID ứng dụng khách OAuth 2.0 cho Ứng dụng Android.

Tất cả ứng dụng Android đều được ký bằng chứng chỉ số mà bạn có khoá riêng tư. Hãy tham khảo Hướng dẫn ký ứng dụng trên Android để biết thêm thông tin về chứng chỉ số.

Mã ứng dụng OAuth của Android được liên kết với các cặp chứng chỉ/gói cụ thể. Bạn chỉ cần một ID cho mỗi chứng chỉ, bất kể bạn có bao nhiêu người dùng ứng dụng.

Bạn cần thực hiện một số bước để lấy mã nhận dạng cho ứng dụng. Các bước này được nêu ở bên dưới.

Tìm thông tin về chứng chỉ của ứng dụng.
Tạo hoặc sửa đổi dự án trong Bảng điều khiển API của Google.
Yêu cầu mã ứng dụng khách OAuth 2.0.

Tìm thông tin về chứng chỉ của ứng dụng

Khoá API dựa trên một dạng ngắn của chứng chỉ kỹ thuật số của ứng dụng, còn gọi là vân tay số SHA-1. Để hiển thị SHA-1 cho chứng chỉ của mình, thì trước tiên hãy đảm bảo rằng bạn đang sử dụng đúng chứng chỉ. Bạn có thể có hai chứng chỉ:

Chứng chỉ gỡ lỗi: Bộ công cụ SDK Android tạo chứng chỉ này tự động khi bạn tạo bản gỡ lỗi. Chỉ sử dụng chứng chỉ này với các ứng dụng mà bạn đang kiểm thử. Đừng tìm cách phát hành ứng dụng đã được ký bằng một chứng chỉ gỡ lỗi. Chứng chỉ gỡ lỗi được mô tả chi tiết hơn trong phần Ký ở chế độ gỡ lỗi trong Tài liệu dành cho nhà phát triển Android.
Chứng chỉ phát hành: Các công cụ SDK Android sẽ tạo chứng chỉ này khi bạn tạo bản phát hành. Bạn cũng có thể tạo chứng chỉ này bằng chương trình keytool. Sử dụng chứng chỉ này khi bạn đã sẵn sàng phát hành ứng dụng ra toàn thế giới.

Hãy làm theo các bước dưới đây để hiển thị vân tay số SHA-1 của chứng chỉ bằng cách sử dụng chương trình keytool với tham số -v. Để biết thêm thông tin về Keytool, hãy xem tài liệu của Oracle.

Chứng chỉ gỡ lỗi

Hiển thị dấu vân tay chứng chỉ gỡ lỗi

Tìm tệp kho khoá gỡ lỗi của bạn. Tên tệp là debug.keystore và được tạo trong lần đầu tiên bạn tạo dự án. Theo mặc định, tệp này được lưu trữ trong cùng thư mục với các tệp Thiết bị ảo Android (AVD):
- macOS và Linux: ~/.android/
- Windows Vista và Windows 7: C:\Users\your_user_name\.android\

Liệt kê vân tay SHA-1:

Đối với Linux hoặc macOS, hãy mở một cửa sổ dòng lệnh rồi nhập như sau:

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

Đối với Windows Vista và Windows 7, hãy chạy:

keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Bạn sẽ thấy kết quả xuất ra có dạng như sau:

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3

Chứng chỉ phát hành

Hiện dấu vân tay chứng chỉ phát hành

Tìm tệp kho khoá chứng chỉ phát hành. Không có vị trí hoặc tên mặc định cho kho khoá phát hành. Nếu bạn không chỉ định khoá ký khi tạo ứng dụng để phát hành, thì bản dựng sẽ để .apk không được ký và bạn sẽ phải ký bản dựng đó trước khi có thể phát hành. Đối với chứng chỉ phát hành, bạn cũng cần có bí danh của chứng chỉ và mật khẩu cho kho khoá cũng như chứng chỉ. Bạn có thể liệt kê các bí danh cho tất cả khoá trong kho khoá bằng cách nhập:
```
keytool -list -keystore your_keystore_name
```
Thay thế your_keystore_name bằng thành phần đủ điều kiện đường dẫn và tên của kho khoá, bao gồm .keystore tiện ích. Bạn sẽ được nhắc nhập mật khẩu của kho khoá. Sau đó, keytool sẽ hiển thị tất cả các bí danh trong kho khoá.
Nhập nội dung sau tại cửa sổ dòng lệnh hoặc dấu nhắc lệnh:
```
keytool -list -v -keystore your_keystore_name -alias your_alias_name
```
Thay thế your_keystore_name bằng thành phần đủ điều kiện đường dẫn và tên của kho khoá, bao gồm .keystore tiện ích. Thay thế your_alias_name bằng bí danh mà bạn đã chỉ định cho chứng chỉ khi tạo.

Bạn sẽ thấy kết quả xuất ra có dạng như sau:

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

Dòng bắt đầu bằng SHA1 chứa SHA-1 của chứng chỉ vân tay số. Dấu vân tay là một chuỗi gồm 20 hệ thập lục phân gồm hai chữ số số được phân tách bằng dấu hai chấm.

Thận trọng: Để bảo vệ kho khoá của bạn và , đừng nhập storepass hoặc keypass đối số trên dòng lệnh trừ khi bạn tự tin về khả năng bảo mật. Ví dụ: trên máy tính công cộng, người khác có thể xem nhật ký cửa sổ dòng lệnh hoặc danh sách các quy trình đang chạy, lấy mật khẩu, sau đó có quyền ghi vào chứng chỉ ký của bạn. Điều này sẽ cho phép người đó sửa đổi hoặc thay thế ứng dụng của bạn bằng ứng dụng của riêng họ.

Yêu cầu mã ứng dụng khách OAuth 2.0 trong Google API Console

Hãy làm theo các bước sau để tạo hoặc sửa đổi dự án cho ứng dụng của bạn trong Bảng điều khiển API của Google, bật API Thể dục và yêu cầu mã ứng dụng OAuth 2.0.

Nếu bạn muốn được hướng dẫn về quy trình và kích hoạt Tự động API Thể dục, nhấp vào

Lấy mã ứng dụng khách

Ngoài ra, hãy làm theo các bước sau để bật API Thể dục trong Google API Console và lấy mã ứng dụng OAuth 2.0.

Chuyển đến Bảng điều khiển API của Google.
Chọn một dự án hoặc tạo dự án mới. Sử dụng cùng một dự án cho Android và REST của ứng dụng.
Nhấp vào Tiếp tục để bật API Fitness.
Nhấp vào Chuyển đến thông tin xác thực.
Nhấp vào Thông tin xác thực mới, sau đó chọn Mã ứng dụng OAuth.
Trong mục Application type (Loại ứng dụng), hãy chọn Android.
Trong hộp thoại hiện ra, hãy nhập gói và vân tay số SHA-1 của ứng dụng . Ví dụ:

BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75

com.example.android.fit-example
Nhấp vào Tạo. Mã ứng dụng khách Android OAuth 2.0 và bí mật mới của bạn sẽ xuất hiện trong danh sách mã cho dự án của bạn. Mã ứng dụng OAuth 2.0 là một chuỗi , có dạng như sau:

780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com