Quyền truy cập và uỷ quyền đối với dữ liệu

API Google Health sử dụng một khung mạnh mẽ và được chuẩn hoá để quản lý quyền truy cập và bảo mật dữ liệu người dùng. Một thành phần chính của quá trình hiện đại hoá này là việc chuyển đổi từ cơ chế uỷ quyền cũ của Fitbit (FOT) sang Google OAuth 2.0. Sự thay đổi này cho phép nhà phát triển tận dụng các thư viện xác thực tiêu chuẩn của Google, đơn giản hoá việc triển khai, đồng thời cung cấp cho người dùng một giao diện quen thuộc và tập trung để quản lý quyền của họ.

Đăng ký ứng dụng

Tất cả ứng dụng Google Health API đều phải được đăng ký bằng Google Cloud Console, đóng vai trò là trung tâm để quản lý tất cả ứng dụng của Google.

Để biết hướng dẫn về cách đăng ký ứng dụng, hãy làm theo các bước trong phần Bắt đầu. Sau đây là những điểm khác biệt mà bạn sẽ nhận thấy khi đăng ký ứng dụng.

Fitbit Web API API Google Health
Đường liên kết công khai https://dev.fitbit.com/apps https://console.cloud.google.com
Thêm ứng dụng mới Nhấn vào Đăng ký ứng dụng mới
  1. Tạo một dự án trên Google Cloud
  2. Bật Google Health API
Thông tin cơ bản Các trường cần hoàn tất:
  • Tên ứng dụng
  • Mô tả
  • URL của trang web ứng dụng
  • Tổ chức
  • URL của trang web của tổ chức
  • URL của Điều khoản dịch vụ
  • URL chính sách bảo mật
Các trường cần hoàn tất:
  • Tên ứng dụng
  • Email của nhóm hỗ trợ
  • Đối tượng (nội bộ hoặc bên ngoài)
  • Email liên hệ
  • Biểu tượng biểu trưng
  • URL của trang web ứng dụng
  • URL chính sách quyền riêng tư
  • URL của Điều khoản dịch vụ
  • Miền được uỷ quyền
Loại ứng dụng Nhà phát triển phải chọn:
  • Máy chủ
  • Khách hàng
  • Cá nhân
  • Ứng dụng web
  • Android
  • Tiện ích Chrome
  • iOS
  • TV
  • Ứng dụng dành cho máy tính
  • Nền tảng Windows thống nhất
Mã ứng dụng khách Được đăng ký khi chế độ cài đặt ứng dụng được lưu Đăng ký riêng
Loại quyền truy cập Quyền đọc và ghi được kiểm soát ở cấp ứng dụng Quyền đọc và ghi được kiểm soát ở cấp phạm vi
URL bổ sung
  • URL chuyển hướng: Trang web mà người dùng được chuyển hướng đến sau khi uỷ quyền cho các phạm vi
  • Nguồn gốc JavaScript được uỷ quyền: Nguồn gốc HTTP lưu trữ ứng dụng web
  • URL chuyển hướng: Trang web mà người dùng được chuyển hướng đến sau khi uỷ quyền cho các phạm vi

Triển khai OAuth

Các ứng dụng API Google Health chỉ hỗ trợ Thư viện ứng dụng Google OAuth2. Thư viện ứng dụng có sẵn cho các khung phổ biến, giúp việc triển khai OAuth 2.0 trở nên đơn giản hơn.

Sự khác biệt giữa thư viện Google OAuth2 và thư viện OAuth2 nguồn mở như sau:

Fitbit Web API API Google Health
Hỗ trợ thư viện OAuth2 Nguồn mở Thư viện ứng dụng Google OAuth2
Chức năng Không nhất quán trên các nền tảng Nhất quán trên nhiều nền tảng
URL uỷ quyền https://www.fitbit.com/oauth2/authorize https://accounts.google.com/o/oauth2/v2/auth
URL mã thông báo https://api.fitbit.com/oauth2/token https://oauth2.googleapis.com/token
Thời gian hoạt động của mã truy cập 8 giờ 1 giờ
Kích thước mã truy cập 1024 byte 2048 byte
Mã làm mới Mã làm mới được tạo khi sử dụng Quy trình cấp mã uỷ quyền. Chỉ có thể tạo 1 mã làm mới cho một người dùng. Mã thông báo không bao giờ hết hạn và chỉ có thể sử dụng một lần. Để tạo mã làm mới, chuỗi uỷ quyền phải chứa tham số truy vấn "access_type=offline". Bạn có thể tạo nhiều mã làm mới cho một người dùng. Mã làm mới có thể dựa trên thời gian. Mã này sẽ hết hạn nếu không được sử dụng trong vòng 6 tháng, người dùng cấp quyền truy cập theo thời gian hoặc ứng dụng đang ở chế độ "Thử nghiệm". Hãy xem phần Hết hạn mã làm mới để biết thêm thông tin.
Phản hồi bằng mã thông báo Nội dung phản hồi JSON chứa:
  • mã truy cập
  • thời hạn của mã truy cập
  • các phạm vi
  • loại mã thông báo
  • mã làm mới
  • Mã nhận dạng người dùng
Nội dung phản hồi JSON chứa:
  • mã truy cập
  • thời hạn của mã truy cập
  • các phạm vi
  • loại mã thông báo
  • mã làm mới

Để lấy mã nhận dạng người dùng, hãy gọi điểm cuối users.getIdentity một lần khi ít nhất một phạm vi của Google Health được cấp và duy trì hoạt động của mã thông báo Fitbit cũ cho đến khi legacyUserId được xác minh.

Người dùng Fitbit phải đồng ý lại với chế độ tích hợp mới của bạn, vì ứng dụng của bạn đang sử dụng một thư viện OAuth khác. Bạn không thể chuyển mã truy cập và mã làm mới sang Google Health API để sử dụng.

Mỗi người dùng đồng ý lại sẽ được tính vào giới hạn cấp mã thông báo OAuth của dự án trên đám mây trên Google Cloud. Google Cloud áp dụng giới hạn tốc độ đối với việc cấp mã thông báo OAuth để kiểm soát tốc độ ứng dụng của bạn có thể thu nạp hoặc xác thực lại người dùng. Nếu bạn dự kiến sẽ vượt quá 10.000 lượt đăng ký hoặc xác thực lại của người dùng trong khoảng thời gian 24 giờ, hãy yêu cầu hạn mức cao hơn trước. Để biết thêm thông tin, hãy xem bài viết Giới hạn về tốc độ của ứng dụng OAuth.