Bắt đầu sử dụng API REST

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.

  1. Chuyển đến Bảng điều khiển API của Google.
  2. 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.
  3. Nhấp vào Tiếp tục để bật API Fitness.
  4. Nhấp vào Chuyển đến trang thông tin xác thực.
  5. Nhấp vào Thông tin xác thực mới, sau đó chọn Mã ứng dụng OAuth.
  6. Trong Application type (Loại ứng dụng), hãy chọn Web application (Ứng dụng web).
  7. 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).
  8. 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).

  9. 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:

  1. Chuyển đến OAuth Playground.
  2. 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.
  3. 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.
  4. 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:

  1. Trong Phương thức HTTP, chọn GET.
  2. Trong URI yêu cầu, nhập https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. 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:

  1. Trong Phương thức HTTP, chọn ĐĂNG.
  2. Trong URI yêu cầu, nhập https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Nhấp vào Nhập nội dung yêu cầu.

  4. 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"
  }
}

  5. Trong cửa sổ Request Content (Nội dung yêu cầu), hãy nhấp vào Close (Đóng).

  6. 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: