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.

API Reference

Tài liệu tham khảo API này được sắp xếp theo loại tài nguyên. Mỗi loại tài nguyên có một hoặc nhiều cách biểu diễn dữ liệu và một hoặc nhiều phương thức.

Users.dataSources

Để biết thông tin chi tiết về Tài nguyên Users.dataSources, hãy xem trang trình bày tài nguyên.

Phương thức	Yêu cầu HTTP	Nội dung mô tả
Các URI so với https://www.googleapis.com/fitness/v1/users, trừ phi có lưu ý khác
tạo	`POST /userId/dataSources`	Tạo một nguồn dữ liệu mới là duy nhất trên tất cả các nguồn dữ liệu thuộc về người dùng này. Nguồn dữ liệu là nguồn dữ liệu cảm biến duy nhất. Các nguồn dữ liệu có thể hiển thị dữ liệu thô từ các cảm biến phần cứng trên thiết bị cục bộ hoặc thiết bị đồng hành. Các đối tượng này cũng có thể hiển thị dữ liệu phát sinh, được tạo bằng cách chuyển đổi hoặc hợp nhất các nguồn dữ liệu khác. Có thể tồn tại nhiều nguồn dữ liệu cho cùng một loại dữ liệu. Mọi điểm dữ liệu trong mỗi tập dữ liệu được chèn vào hoặc đọc từ API Thể dục đều có một nguồn dữ liệu được liên kết. Mỗi nguồn dữ liệu tạo ra một luồng nội dung cập nhật tập dữ liệu riêng biệt, với một giá trị nhận dạng nguồn dữ liệu duy nhất. Không phải mọi thay đổi đối với nguồn dữ liệu đều ảnh hưởng đến mã luồng dữ liệu. Do đó, dữ liệu do các phiên bản cập nhật của cùng một ứng dụng/thiết bị thu thập vẫn có thể được coi là thuộc về cùng một nguồn dữ liệu. Nguồn dữ liệu được xác định bằng một chuỗi do máy chủ tạo, dựa trên nội dung của nguồn đang được tạo. Bạn không nên đặt trường `dataStreamId` khi gọi phương thức này. Hệ thống sẽ tự động tạo báo cáo này cho máy chủ theo định dạng chính xác. Nếu bạn đặt `dataStreamId`, thì đối tượng này phải khớp với định dạng mà máy chủ sẽ tạo. Định dạng này là sự kết hợp của một số trường từ nguồn dữ liệu và có thứ tự cụ thể. Nếu không khớp, yêu cầu sẽ không thành công kèm theo lỗi. Việc chỉ định một DataType không phải là một kiểu đã biết (bắt đầu với "com.google.") sẽ tạo một DataSource có loại dữ liệu tuỳ chỉnh. Chỉ ứng dụng tạo ra các loại dữ liệu đó mới đọc được các loại dữ liệu tuỳ chỉnh đó. Các kiểu dữ liệu tuỳ chỉnh không dùng nữa; hãy sử dụng các kiểu dữ liệu chuẩn. Ngoài các trường nguồn dữ liệu có trong mã nguồn dữ liệu, số dự án nhà phát triển đã được xác thực khi tạo nguồn dữ liệu cũng được đưa vào. Số dự án của nhà phát triển này bị làm rối mã nguồn khi được bất kỳ nhà phát triển nào khác đọc các loại dữ liệu công khai.
xóa	`DELETE /userId/dataSources/dataSourceId`	Xoá nguồn dữ liệu đã chỉ định. Yêu cầu sẽ không thành công nếu nguồn dữ liệu chứa bất kỳ điểm dữ liệu nào.
nhận	`GET /userId/dataSources/dataSourceId`	Trả về nguồn dữ liệu đã chỉ định.
list	`GET /userId/dataSources`	Liệt kê tất cả nguồn dữ liệu mà nhà phát triển có thể nhìn thấy, bằng cách sử dụng các phạm vi OAuth được cung cấp. Danh sách này chưa đầy đủ; người dùng có thể có các nguồn dữ liệu riêng tư mà chỉ các nhà phát triển khác mới nhìn thấy, hoặc các lệnh gọi sử dụng các phạm vi khác.
cập nhật	`PUT /userId/dataSources/dataSourceId`	Cập nhật nguồn dữ liệu đã chỉ định. Bạn không thể sửa đổi các thuộc tính `dataStreamId`, `dataType`, `type`, `dataStreamName` và `device` (ngoại trừ `version`). Nguồn dữ liệu được xác định bằng `dataStreamId` của chúng.

Users.dataSources.dataPointChanges

Để biết chi tiết về Tài nguyên Users.dataSources.dataPointChanges, hãy xem trang nội dung trình bày về tài nguyên.

Phương thức	Yêu cầu HTTP	Nội dung mô tả
Các URI so với https://www.googleapis.com/fitness/v1/users, trừ phi có lưu ý khác
list	`GET /userId/dataSources/dataSourceId/dataPointChanges`	Truy vấn các thay đổi về điểm dữ liệu của người dùng đối với một nguồn dữ liệu cụ thể.

Users.dataSources.datasets

Để biết thông tin về tài nguyên Users.dataSources.datasets, hãy xem trang trình bày tài nguyên.

Phương thức	Yêu cầu HTTP	Nội dung mô tả
Các URI so với https://www.googleapis.com/fitness/v1/users, trừ phi có lưu ý khác
xóa	`DELETE /userId/dataSources/dataSourceId/datasets/datasetId`	Thực hiện xoá toàn bộ tất cả các điểm dữ liệu có thời gian bắt đầu và thời gian kết thúc trùng lặp với phạm vi thời gian do mã tập dữ liệu chỉ định. Đối với hầu hết các loại dữ liệu, toàn bộ điểm dữ liệu sẽ bị xoá. Đối với các loại dữ liệu có khoảng thời gian biểu thị một giá trị nhất quán (chẳng hạn như `com.google.activity.segment`) và một điểm dữ liệu nằm trên một trong hai điểm cuối của tập dữ liệu, thì chỉ phần chồng chéo của điểm dữ liệu sẽ bị xoá.
nhận	`GET /userId/dataSources/dataSourceId/datasets/datasetId`	Trả về một tập dữ liệu chứa tất cả các điểm dữ liệu có thời gian bắt đầu và thời gian kết thúc trùng lặp với phạm vi thời gian bắt đầu tối thiểu và thời gian kết thúc tối đa đã chỉ định của tập dữ liệu. Cụ thể, bất kỳ điểm dữ liệu nào có thời gian bắt đầu nhỏ hơn hoặc bằng thời gian kết thúc tập dữ liệu và có thời gian kết thúc lớn hơn hoặc bằng thời gian bắt đầu tập dữ liệu.
bản vá	`PATCH /userId/dataSources/dataSourceId/datasets/datasetId`	Thêm các điểm dữ liệu vào một tập dữ liệu. Tập dữ liệu không cần được tạo trước đó. Tất cả các điểm trong tập dữ liệu đã cho sẽ được trả về bằng các lệnh gọi phụ để truy xuất tập dữ liệu này. Các điểm dữ liệu có thể thuộc về nhiều tập dữ liệu. Phương thức này không sử dụng ngữ nghĩa của bản vá: các điểm dữ liệu được cung cấp chỉ được chèn vào mà không có dữ liệu hiện có nào được thay thế.

Users.dataset

Để biết thông tin chi tiết về Tài nguyên Users.dataset, hãy xem trang trình bày tài nguyên.

Phương thức	Yêu cầu HTTP	Nội dung mô tả
Các URI so với https://www.googleapis.com/fitness/v1/users, trừ phi có lưu ý khác
tổng hợp	`POST /userId/dataset:aggregate`	Tổng hợp dữ liệu thuộc một loại hoặc luồng nhất định thành các nhóm được chia theo một loại ranh giới nhất định. Bạn có thể tổng hợp nhiều tập dữ liệu thuộc nhiều loại và từ nhiều nguồn thành một loại nhóm cho mỗi yêu cầu.

Users.sessions

Để biết thông tin chi tiết về Tài nguyên Users.sessions, hãy xem trang trình bày tài nguyên.

Phương thức	Yêu cầu HTTP	Nội dung mô tả
Các URI so với https://www.googleapis.com/fitness/v1/users, trừ phi có lưu ý khác
xóa	`DELETE /userId/sessions/sessionId`	Xoá phiên do mã phiên đã cho chỉ định.
list	`GET /userId/sessions`	Liệt kê các phiên đã tạo trước đây.
cập nhật	`PUT /userId/sessions/sessionId`	Cập nhật hoặc chèn một phiên nhất định.