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

Hướng dẫn này cho bạn biết cách kích hoạt quyền truy cập vào API Fitness REST, lấy mã truy cập OAuth và gọi các phương thức API bằng các yêu cầu HTTP.

Để sử dụng API Fitness REST, bạn cần hiểu rõ 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 có thể bắt đầu sử dụng. Bạn cũng nê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. Truy cập vào Google API Console.
  2. Chọn một 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 thông tin xác thực.
  5. Nhấp vào Thông tin xác thực mới, rồi chọn Mã ứng dụng khách 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 mới và thông tin bí mật sẽ xuất hiện trong danh sách mã 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. Truy cập vào 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 Uỷ quyền API, chọn dự án Google API Console mà bạn muốn sử dụng rồi nhấp vào Cho phép khi được nhắc. Bạn sẽ có thể truy cập và chỉnh sửa dữ liệu liên kết với tài khoản Google API Console đã chọn.
  4. Nhấp vào nút Trao đổi mã uỷ quyền lấy 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 HTTP Method (Phương thức HTTP), hãy 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 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 Body (Phần thân 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 sẽ 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 sẽ cần có mã truy cập OAuth để đưa ra yêu cầu bằng cURL (xem hướng dẫn trước đó). Xin lưu ý rằng mã thông báo truy cập sẽ hết hạn sau một giờ. Ví dụ sau đây cho thấy một 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: