Hướng dẫn này chỉ cho bạn cách kích hoạt quyền truy cập vào Fitness REST API, nhận quyền truy cập OAuth mã thông báo và gọi các phương thức API bằng cách sử dụng yêu cầu HTTP.
Để sử dụng API Fitness REST, bạn phải nắm được kiến thức cơ bản về Dịch vụ web RESTful và biểu diễn JSON.
Tạo tài khoản Google
Để sử dụng API Fitness REST, bạn cần có Tài khoản Google. Nếu đã có tài khoản thì bạn đã hoàn tất. Có thể bạn cũng muốn tạo một Tài khoản Google riêng cho mục đích thử nghiệm.
Yêu cầu mã ứng dụng khách OAuth 2.0
Hãy làm theo các bước sau để yêu cầu mã ứng dụng khách OAuth 2.0 cho Fitness API.
- Chuyển đến Bảng điều khiển API của Google.
- Chọn dự án hoặc tạo dự án mới. Sử dụng cùng một dự án cho Android và REST của ứng dụng.
- Nhấp vào Tiếp tục để bật API Fitness.
- Nhấp vào Chuyển đến trang thông tin xác thực.
- Nhấp vào Thông tin xác thực mới, sau đó chọn Mã ứng dụng OAuth.
- Trong Application type (Loại ứng dụng), hãy chọn Web application (Ứng dụng web).
- Trong phần Nguồn gốc JavaScript được cho phép, hãy nhập URL cơ sở của trang web
nguồn gốc của các yêu cầu (ví dụ:
https://developers.google.com
là URL mà OAuth Playground sử dụng). - Trong mục URI chuyển hướng được phép, hãy nhập URL của trang web chứa phản hồi
sẽ được xử lý (ví dụ:
https://developers.google.com/oauthplayground
là URL mà OAuth Playground sử dụng). Nhấp vào Tạo. Mã ứng dụng khách OAuth 2.0 và bí mật mới của bạn sẽ xuất hiện trong danh sách cho dự án của bạn. Mã ứng dụng OAuth 2.0 là một chuỗi ký tự, tương tự như sau:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com
Dùng thử API REST trong OAuth Playground
OAuth Playground là cách dễ nhất để làm quen với API REST thể dục bằng cách gửi các yêu cầu HTTP và quan sát các phản hồi trước khi bạn viết bất kỳ mã ứng dụng khách nào.
Cách uỷ quyền API Fitness REST trong OAuth Playground:
- Chuyển đến OAuth Playground.
- Trong Bước 1, hãy chọn & uỷ quyền cho API, mở rộng mục Thể dục phiên bản 1 rồi chọn Phạm vi thể dục để sử dụng.
- Nhấp vào nút Authorize APIs (Cho phép API), chọn dự án Google API Console để sử dụng và nhấp vào Cho phép khi được nhắc. Bạn sẽ có thể truy cập và sửa đổi dữ liệu được liên kết với tài khoản Google API Console đã chọn.
- Nhấp vào nút Mã uỷ quyền Exchange cho mã thông báo. OAuth
Playground tự động đưa tiêu đề này vào
Authorization:
khi gửi yêu cầu HTTP. Xin lưu ý rằng mã truy cập sẽ hết hạn sau 60 phút (3600 giây).
Gửi yêu cầu HTTP
Các ví dụ sau minh hoạ cách gửi yêu cầu HTTP để liệt kê tất cả nguồn dữ liệu có sẵn và tạo nguồn dữ liệu mới. Dành cho Kiến trúc chuyển trạng thái thể dục (REST) API, định dạng URI là:
https://www.googleapis.com/fitness/v1/resourcePath?parameters
Cách liệt kê tất cả các nguồn dữ liệu có sẵn:
- Trong Phương thức HTTP, chọn GET.
- Trong URI yêu cầu, nhập
https://www.googleapis.com/fitness/v1/users/me/dataSources
- Nhấp vào Gửi yêu cầu.
Yêu cầu và phản hồi sẽ xuất hiện ở phía bên phải của trang. Nếu yêu cầu thành công, phản hồi cho thấy nguồn dữ liệu từ ví dụ ở định dạng JSON.
Cách tạo một nguồn dữ liệu:
- Trong Phương thức HTTP, chọn ĐĂNG.
- Trong URI yêu cầu, nhập
https://www.googleapis.com/fitness/v1/users/me/dataSources
- Nhấp vào Nhập nội dung yêu cầu.
Trong cửa sổ Request body (Yêu cầu nội dung), hãy sao chép và dán tệp JSON sau:
{ "dataStreamName": "MyDataSource", "type": "derived", "application": { "detailsUrl": "http://example.com", "name": "Foo Example App", "version": "1" }, "dataType": { "field": [ { "name": "steps", "format": "integer" } ], "name": "com.google.step_count.delta" }, "device": { "manufacturer": "Example Manufacturer", "model": "ExampleTablet", "type": "tablet", "uid": "1000001", "version": "1" } }
Trong cửa sổ Request Content (Nội dung yêu cầu), hãy nhấp vào Close (Đóng).
Nhấp vào Gửi yêu cầu.
Yêu cầu và phản hồi sẽ xuất hiện ở phía bên phải của trang. Yêu cầu
bao gồm mã truy cập OAuth trong tiêu đề Authorization
:
Authorization: Bearer ya29.OAuthTokenValue
Nếu yêu cầu thành công, dòng đầu tiên của phản hồi là:
HTTP/1.1 200 OK
Dùng cURL để truy cập vào API Fit REST
Bạn có thể sử dụng công cụ dòng lệnh cURL để truy cập vào API Fit REST. Bạn cần có mã truy cập OAuth để thực hiện yêu cầu bằng cách sử dụng cURL (xem hướng dẫn trước đó). Xin lưu ý rằng mã truy cập sẽ hết hạn sau một giờ. Ví dụ sau đây cho thấy tập lệnh bash đơn giản để liệt kê tất cả các nguồn dữ liệu.
#!/bin/bash ACCESS_TOKEN="" curl \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ https://www.googleapis.com/fitness/v1/users/me/dataSources
Các bước tiếp theo
Để tìm hiểu thêm về API REST, hãy xem các trang sau: