Mọi yêu cầu mà ứng dụng của bạn gửi đến Fitness API phải bao gồm một mã thông báo uỷ quyền. Mã này cũng giúp Google xác định ứng dụng của bạn.
Giao thức uỷ quyền
Ứng dụng của bạn phải sử dụng OAuth 2.0 để uỷ quyền cho các yêu cầu. Chúng tôi không hỗ trợ giao thức cấp phép nào khác. Nếu ứng dụng của bạn sử dụng tính năng Đăng nhập bằng Google, thì Google sẽ xử lý một số khía cạnh trong quá trình uỷ quyền cho bạn.
Các loại dữ liệu mà ứng dụng của bạn muốn truy cập tương ứng với các phạm vi. Để có thể truy cập vào các loại dữ liệu, bạn cần xác định xem phạm vi tương ứng của các loại dữ liệu đó có nhạy cảm hay bị hạn chế hay không và làm theo các bước liên quan khi đăng ký xác minh. Hãy xem bước 3 của quy trình cấp quyền cho yêu cầu dưới đây.
Cấp phép cho các yêu cầu bằng OAuth 2.0
Tất cả các yêu cầu đối với Fitness API phải được một người dùng đã xác thực cho phép.
Thông tin chi tiết về quy trình cấp quyền hay "luồng" của OAuth 2.0 sẽ phụ thuộc vào loại ứng dụng mà bạn đang viết. Quy trình chung này áp dụng cho tất cả các loại ứng dụng:
- Khi bạn tạo ứng dụng, hãy đăng ký ứng dụng đó bằng Google API Console. Sau đó, Google cung cấp thông tin bạn sẽ cần sau này, chẳng hạn như mã ứng dụng khách và mật khẩu ứng dụng khách.
- Kích hoạt API Thể dục trong Bảng điều khiển Google API. (Nếu API không được liệt kê trong Bảng điều khiển API, hãy bỏ qua bước này.)
- Đăng ký xác minh và gửi thông tin hỗ trợ liên quan về lý do ứng dụng của bạn cần các phạm vi nhất định. Các loại dữ liệu mà ứng dụng của bạn cần truy cập tương ứng với các phạm vi mà ứng dụng của bạn cần yêu cầu.
- Nếu ứng dụng của bạn đã được xác minh, Google sẽ hiển thị màn hình xin phép người dùng để yêu cầu họ cho phép ứng dụng truy cập vào dữ liệu của họ.
- Nếu người dùng chấp thuận, thì Google sẽ cấp cho ứng dụng của bạn một mã truy cập ngắn hạn.
- Sau đó, ứng dụng yêu cầu dữ liệu người dùng và đính kèm mã truy cập trong yêu cầu.
- Nếu xác định rằng yêu cầu của bạn và mã thông báo là hợp lệ, Google sẽ trả về dữ liệu được yêu cầu.
Đọc về phạm vi OAuth cho API Thể dục tại đây. Tìm hiểu phạm vi cần thiết cho từng loại dữ liệu.