Ghi chú phát hành

Ngày 14 tháng 10 năm 2026

Lọc nhóm nguồn dữ liệu

Đã cập nhật tính năng lọc nguồn dữ liệu cho gia đình bằng các chức năng sau:

  • Thêm tính năng hỗ trợ tham số dataSourceFamily cho điểm cuối users.dataTypes.dataPoints list cho tất cả các loại dữ liệu ngoại trừ sleep, food và food-measurement-unit.
  • Thêm nhóm nguồn dữ liệu users/me/dataSourceFamilies/self-sources vào các điểm cuối list, reconcile, rollUp và dailyRollUp để ứng dụng có thể truy vấn các điểm dữ liệu mà họ tự viết, kể cả khi chỉ được cấp phạm vi .writeonly.

Các bản cập nhật tài liệu nổi bật

  • Cập nhật hướng dẫn Lọc dữ liệu kèm theo thông tin chi tiết và ví dụ về cách sử dụng dataSourceFamily trên điểm cuối list, truy vấn self-sources bằng phạm vi chỉ ghi và xử lý các giới hạn về loại dữ liệu.

Ngày 1 tháng 10 năm 2026

Kênh thử nghiệm Beta mới

Đã thêm kênh v4beta để làm bản dùng trước công khai cho việc thử nghiệm rộng rãi của đối tác và xác thực thị trường trước khi chuyển sang kênh v4 ổn định. Các phần tử API chỉ có trong v4beta sẽ được gắn thẻ v4beta trong tài liệu.

Hãy xem tài liệu tham khảo để biết thêm thông tin.

Loại dữ liệu mới

Thêm tính năng hỗ trợ cho loại dữ liệu sau:

  • Chỉ số sức khoẻ và thông tin đo lường: skin-temperature-sensors v4beta

Hướng dẫn về API mới

Đã thêm hướng dẫn mới về Nhiệt độ trên da, trong đó trình bày chi tiết cách sử dụng các loại dữ liệu liên quan đến nhiệt độ trên da.

Ngày 17 tháng 8 năm 2026

Phạm vi mới

Đã thêm các phạm vi chỉ ghi sau:

  • .logged_symptoms.writeonly để ghi nhật ký các triệu chứng thể chất.
  • .mindfulness.writeonly để ghi lại trạng thái cảm xúc và tâm trạng.
  • .reproductive_health.writeonly để ghi nhật ký kỳ kinh nguyệt và kết quả kiểm tra rụng trứng.

Loại dữ liệu mới

Bổ sung tính năng hỗ trợ cho các loại dữ liệu sau:

  • Sức khoẻ phụ nữ: menstrual-period, moods, ovulation-test, symptoms

Các bản cập nhật tài liệu nổi bật

Ngày 14 tháng 8 năm 2026

Hướng dẫn di chuyển mới

Chúng tôi đã cập nhật Tổng quan về việc di chuyển với hướng dẫn toàn diện hơn và xoá một số nội dung lỗi thời.

Trang mới để quảng bá Google Health

Trang Quảng bá Google Health mới đề cập đến các cách nên dùng để giới thiệu Google Health trong ứng dụng của bạn và cách khuyến khích người dùng kết nối. Đây cũng là vị trí mới cho nguyên tắc sử dụng thương hiệu của Google Health.

Ngày 22 tháng 6 năm 2026

Trang tổng quan về trạng thái của Google Health

Thêm Trang tổng quan về trạng thái của Google Health để cung cấp thông tin về trạng thái của các dịch vụ thuộc Google Health.

Ngày 17 tháng 6 năm 2026

Công cụ tương đương API của Google Health

Cập nhật công cụ tương đương của Google Health API bằng các phạm vi bổ sung: active-energy-burned, electrocardiogram, core-body-temperature, blood-glucose, irregular-rhythm-notification, food, food-measurement-unit, nutrition-log và exportExerciseTcx.

Ngày 26 tháng 5 năm 2026

Phạm vi mới

  • .ecg.readonly để đọc dữ liệu điện tâm đồ.
  • .irn.readonly để đọc dữ liệu IRN.

Thay đổi tên phạm vi

Thay thế phạm vi đọc/ghi bằng .writeonly. Giờ đây, nhà phát triển phải chỉ định rõ ràng quyền đọc và quyền ghi.

  • .activity_and_fitness đổi tên thành .activity_and_fitness.writeonly
  • .health_metrics_and_measurements đổi tên thành .health_metrics_and_measurements.writeonly
  • .nutrition đổi tên thành .nutrition.writeonly
  • .profile đổi tên thành .profile.writeonly
  • .settings đổi tên thành .settings.writeonly
  • .sleep đổi tên thành .sleep.writeonly

Loại dữ liệu mới

Bổ sung tính năng hỗ trợ cho các loại dữ liệu sau:

  • Hoạt động và thể dục: active-energy-burned
  • ECG: electrocardiogram
  • Chỉ số sức khoẻ và số đo: core-body-temperature, blood-glucose
  • IRN: irregular-rhythm-notification
  • Dinh dưỡng: food, food-measurement-unit, nutrition-log

Điểm cuối mới

  • project.subscribers.subscriptions: Các phương thức create, delete, list và patch để quản lý gói thuê bao theo cách thủ công.
  • users: getIrnProfile trả về mức độ tương tác hiện tại của người dùng với tính năng IRN
  • users.pairedDevices: get và list các thiết bị được ghép nối với tài khoản của người dùng.

Webhook

Thêm tính năng hỗ trợ cho chức năng webhook sau:

  • Hỗ trợ đăng ký thủ công khi người đăng ký đã đăng ký.
  • Hỗ trợ thông báo cho các loại dữ liệu activityLevel, bloodGlucose, dailyRespiratoryRate, heartRateVariability, height, hydrationLog, nutritionLog, respiratoryRateSleepSummary, runVo2Max, sedentaryPeriod, timeInHeartRateZone.
  • Hỗ trợ các chỉ số tùy chỉnh, cảnh báo và lỗi của người đăng ký trong Google Cloud Console.
  • Tự động thử gửi lại thông báo webhook không thành công trong tối đa 7 ngày nếu mất kết nối với người đăng ký.

Các bản cập nhật tài liệu nổi bật

Ngày 14 tháng 4 năm 2026

Loại dữ liệu mới

  • Hoạt động và thể dục: swim-lengths-data
  • Chỉ số sức khoẻ và số đo: height

Điểm cuối mới

  • project.subscribers: Các phương thức delete, get, list và patch để quản lý gói thuê bao theo cách thủ công.
  • users.dataTypes.dataPoints: get trả về một điểm dữ liệu dựa trên mã nhận dạng.

Hỗ trợ webhook

  • Tự động tạo gói thuê bao khi người đăng ký được đăng ký.
  • Quản lý gói thuê bao theo cách thủ công bằng các điểm cuối project.subscribers
  • Hỗ trợ thông báo cho các loại dữ liệu activeZoneMinutes, altitude, bodyFat, caloriesInHeartRateZone, dailyHeartRateVariability, dailyHeartRateZones, dailyOxygenSaturation, dailyRestingHeartRate, dailySleepTemperatureDerivations, distance, exercise, floors, heartRate, sleep, steps, totalCalories và weight.

Các tính năng bổ sung

  • Thư viện REST trên GitHub: Thư viện REST của Google Health API được cung cấp cho tất cả thư viện ứng dụng được hỗ trợ có trong dự án Google API trên GitHub.
  • Hỗ trợ API Explorer: Bạn có thể gọi các điểm cuối bằng API Explorer được tích hợp vào tài liệu tham khảo.
  • Hỗ trợ OAuth Playground: Google Health API phiên bản 4 có trong danh sách trên OAuth 2.0 Playground, một công cụ cho phép bạn gọi các điểm cuối hỗ trợ Thư viện OAuth của Google.

Ngày 24 tháng 3 năm 2026

Thông báo ra mắt Google Health API

Google Health API là thế hệ tiếp theo của Fitbit Web API, được xây dựng từ đầu và thiết kế cho cộng đồng nhà phát triển quý giá của chúng tôi. Bản phát hành đầu tiên này tập trung vào việc đạt được sự tương đương với Fitbit Web API trên các loại dữ liệu được yêu cầu nhiều nhất, đồng thời bổ sung chức năng mà cộng đồng nhà phát triển yêu cầu. Sau đây là thông tin về các tính năng hiện có.

Điểm nổi bật về các tính năng cốt lõi

  • Thiết lập đơn giản: Đăng ký dự án và quản lý mã ứng dụng khách OAuth ngay trong Google Cloud Console quen thuộc.
  • Hỗ trợ nhiều nền tảng: Xây dựng trên thư viện Google OAuth2 để tích hợp liền mạch trên tất cả các ngôn ngữ lập trình và nền tảng chính.
  • Đơn giản hoá quyền truy cập dữ liệu: Sử dụng các định nghĩa phạm vi mới để hợp nhất nhiều loại dữ liệu vào một phạm vi duy nhất, dễ quản lý.
  • Điểm cuối nhất quán trên các loại dữ liệu: Trải nghiệm hành trình lập trình đơn giản hơn với các điểm cuối mới, đồng nhất và tính năng hỗ trợ bộ lọc được thiết kế để đơn giản hoá chức năng trên tất cả các loại dữ liệu.
  • Phạm vi dữ liệu toàn diện: Hỗ trợ đọc và ghi trên nhiều loại dữ liệu.
  • Thông báo theo thời gian thực: Nhận thông tin cập nhật ngay lập tức nhờ tính năng hỗ trợ Webhook nâng cao, bao gồm cả việc tự động tạo gói thuê bao và nội dung thông báo phong phú hơn.
  • Hỗ trợ mặc định trong ngày: Truy xuất dữ liệu chi tiết trong ngày theo mặc định bằng cách sử dụng điểm cuối danh sách, giúp loại bỏ các bước bổ sung.
  • Bộ tài liệu đầy đủ: Nhanh chóng bắt đầu sử dụng nhờ bộ tài liệu mới và toàn diện của chúng tôi, bao gồm:
    • Hướng dẫn bắt đầu, API, di chuyển và khắc phục sự cố
    • Hướng dẫn tham khảo đầy đủ về REST
    • Công cụ mới về tính tương đương của Google Health API, mã mẫu và lớp học lập trình có hướng dẫn

Các loại dữ liệu được hỗ trợ

Lần ra mắt này cung cấp quyền truy cập vào các loại dữ liệu thiết yếu, đảm bảo bạn có thông tin cốt lõi cần thiết để xây dựng các giải pháp sức khoẻ sáng tạo.

Các loại dữ liệu hỗ trợ quyền đọc:

  • Hoạt động và thể dục: Số phút hoạt động, Số phút hoạt động cho vùng nhịp tim, Mức độ hoạt động, Độ cao, Lượng calo trong vùng nhịp tim, Lượng oxy tối đa hằng ngày, Quãng đường, Bài tập thể dục, Số tầng, Lượng oxy tối đa khi chạy, Thời gian ít vận động, Số bước, Thời gian trong vùng nhịp tim, Tổng lượng calo, Lượng oxy tối đa
  • Chỉ số sức khoẻ và số đo: Lượng mỡ trong cơ thể, Sự thay đổi tần số tim hằng ngày, Vùng tần số tim hằng ngày, Độ bão hoà oxy hằng ngày, Nhịp thở hằng ngày, Tần số tim lúc nghỉ ngơi hằng ngày, Độ lệch nhiệt độ khi ngủ hằng ngày, Tần số tim, Sự thay đổi tần số tim, Độ bão hoà oxy, Nhịp thở, Bản tóm tắt về giấc ngủ, Cân nặng
  • Danh tính: Trả về mã nhận dạng người dùng Fitbit và mã nhận dạng người dùng Google
  • Vị trí: Dữ liệu GPS dựa trên một bài tập được ghi lại, hiển thị ở định dạng TCX
  • Dinh dưỡng: Nhật ký về lượng nước uống
  • Hồ sơ: Thông tin hồ sơ cơ bản của người dùng
  • Cài đặt: Người dùng đã định cấu hình chế độ cài đặt thiết bị và ứng dụng di động
  • Giấc ngủ: Nhật ký giấc ngủ cổ điển và theo giai đoạn

Các loại dữ liệu hỗ trợ ghi:

Bạn có thể ghi và sửa đổi dữ liệu cho các loại dữ liệu sau:

  • Hoạt động và thể dục: Tập thể dục
  • Chỉ số sức khoẻ và số đo: Lượng mỡ trong cơ thể, Cân nặng
  • Hồ sơ
  • Cài đặt
  • Ngủ (Sleep)

Các điểm cuối chính để tương tác

Bạn có thể sử dụng các điểm cuối sau để quản lý gói thuê bao, người dùng và dữ liệu thể chất:

  • users: Các phương thức getIdentity, getProfile, getSettings, updateProfile và updateSettings để quản lý danh tính và hồ sơ.
  • users.dataTypes.dataPoints: Các phương thức batchDelete, dailyRollUp, list, patch, reconcile và rollUp để quản lý kiểu dữ liệu toàn diện.