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 thể dục REST, lấy mã thông báo truy cập OAuth và gọi các phương thức API bằng yêu cầu HTTP.

Để sử dụng API REST cho thể dục, bạn phải hiểu 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. 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

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 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 các phiên bản Android và REST của ứng dụng.
  3. Nhấp vào Tiếp tục để bật Fitness API.
  4. Nhấp vào Chuyển đến thông tin xác thực.
  5. Nhấp vào Thông tin đăng nhập 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 phát sinh yêu cầu (ví dụ: https://developers.google.com là URL mà OAuth Playground sử dụng).
  8. Trong URI chuyển hướng được ủy quyền, hãy nhập URL của trang web nơi 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à mã bí mật sẽ xuất hiện trong danh sách mã nhận dạng cho dự án của bạn. Mã ứng dụng khách OAuth 2.0 là một chuỗi các ký tự, đại loại 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 của 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 nào.

Cách cho phép API REST thể dục trong OAuth Playground:

  1. Truy cập vào Play Playground.
  2. Trong Bước 1, Chọn và uỷ quyền API, hãy mở rộng Fitness v1 và chọn phạm vi Thể dục mà bạn muốn sử dụng.
  3. Nhấp vào nút Authorize API (Cho phép API), chọn dự án trong Google API Console để sử dụng và nhấp vào Allow (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 sẽ tự động đưa tiêu đề này vào tiêu đề của yêu cầu Authorization: khi bạn gửi các 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 đây minh hoạ cách gửi yêu cầu HTTP để liệt kê tất cả các nguồn dữ liệu có sẵn và để tạo một nguồn dữ liệu mới. Đối với API Fitness REST, đị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, hãy chọn GET.
  2. Trong URI yêu cầu, hãy 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 sẽ hiển thị nguồn dữ liệu từ ví dụ trước ở định dạng JSON.

Cách tạo nguồn dữ liệu:

  1. Trong Phương thức HTTP, hãy chọn POST.
  2. Trong URI yêu cầu, hãy 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 (Nội dung yêu cầu), 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 (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 sẽ là:

HTTP/1.1 200 OK

Sử dụng cURL để truy cập vào API Fit REST

Bạn có thể 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 để thực hiện yêu cầu bằng cURL (xem instructions 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 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: