Ghi chú phát hành

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

Phạm vi mới

  • .ecg.readonly để đọc dữ liệu điện tâm đồ (ECG).
  • .irn.readonly để đọc dữ liệu thông báo nhịp tim không đều (IRN).

Thay đổi tên phạm vi

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

Đã thêm tính năng hỗ trợ cho các loại dữ liệu sau:

  • Hoạt động và thể chất: 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 thông báo nhịp tim không đều
  • 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ợ gói thuê bao thủ công khi người đăng ký được đă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ố, cảnh báo và lỗi của người đăng ký tuỳ chỉnh trong Google Cloud Console.
  • Tự động thử lại thông báo webhook không thành công trong tối đa 7 ngày nếu mất liên lạc với người đăng ký.

Các điểm nổi bật về nội dung cập nhật trong tài liệu

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

Loại dữ liệu mới

  • Hoạt động và thể chất: 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 khác

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à được 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 ban đầu 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, cùng với việc thêm chức năng mà cộng đồng nhà phát triển đã yêu cầu. Hãy xem 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ý trực tiếp mã ứng dụng OAuth thông qua Google Cloud Console quen thuộc.
  • Hỗ trợ nhiều nền tảng: Xây dựng trên các thư viện Google OAuth2 để tích hợp liền mạch trên tất cả các ngôn ngữ và nền tảng lập trình 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 giúp hợp nhất nhiều loại dữ liệu thành 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 viết mã đơn giản hơn với các điểm cuối mới, đồng nhất và 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: Truy cập vào tính năng 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 ngay thông tin cập nhật với tính năng hỗ trợ webhook nâng cao, bao gồm tính năng tự động tạo gói đăng ký 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 thật chi tiết trong ngày theo mặc định bằng điểm cuối danh sách, loại bỏ các bước bổ sung.
  • Bộ tài liệu hoàn chỉnh: Nhanh chóng bắt đầu sử dụng với bộ tài liệu toàn diện mới 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 đủ cho REST
    • Công cụ tương đồng Google Health API mới, mã mẫu và lớp học lập trình có hướng dẫn

Loại dữ liệu được hỗ trợ

Bản phát hành 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ợ đọc:

  • Hoạt động và thể chất: Số phút hoạt động, Số phút trong vùng hoạt động, 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, 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, Các chỉ số nhiệt độ khi ngủ hàng ngày, Tần số tim, Sự thay đổi tần số tim, Độ bão hoà oxy, Tóm tắt 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 ở định dạng TCX
  • Dinh dưỡng: Nhật ký về lượng nước uống
  • Hồ sơ: Thông tin cơ bản về hồ sơ người dùng
  • Cài đặt: Các chế độ cài đặt thiết bị và ứng dụng di động mà người dùng đã định cấu hình
  • Ngủ: Nhật ký về giấc ngủ cơ bản và các giai đoạn ngủ

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ể chất: Bài tập
  • Chỉ số sức khoẻ và số đo: Lượng mỡ trong cơ thể, Cân nặng
  • Hồ sơ
  • Cài đặt
  • Ngủ

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 về sức khoẻ và 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ý toàn diện các loại dữ liệu.