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 REST thể dục, 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 của Fitness, bạn cần hiểu rõ kiến thức cơ bản về dịch vụ web RESTbiểu thị bằng JSON.

Tạo tài khoản Google

Để sử dụng API REST của Fitness, 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

Hãy làm theo các bước sau để yêu cầu mã ứng dụng khách OAuth 2.0 cho API Thể dục.

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

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Dùng thử API REST trong OAuth Playground

Playground của OAuth là cách dễ nhất để làm quen với API REST của Fit 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 cấp quyền truy cập API REST của Fitness trong OAuth Playground:

  1. Truy cập vào OAuth Playground.
  2. Trong Bước 1 Chọn và amp; cho phép API, mở rộng Thể dục v1 và 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 Bảng điều khiển API của Google để 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 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. Playground tự động bao gồm tiêu đề này trong tiêu đề của yêu cầu Authorization: khi bạn 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. Đối với API REST thể dục, định dạng URI là:

https://www.googleapis.com/fitness/v1/resourcePath?parameters

Để 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, 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 xuất hiện ở bên phải 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 phần 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 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 xuất hiện ở bên phải trang. Yêu cầu này có 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 trong phản hồi là:

HTTP/1.1 200 OK

Sử 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 REST của Fit. Bạn sẽ cần có mã truy cập OAuth để thực hiện các 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ả 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: