Mulai Menggunakan REST API

Tutorial ini menunjukkan cara mengaktifkan akses ke Kebugaran REST API, mendapatkan token akses OAuth, dan memanggil metode API menggunakan permintaan HTTP.

Untuk menggunakan Kebugaran REST API, Anda harus memahami dasar-dasar layanan web RESTful dan representasi JSON.

Membuat Akun Google

Untuk menggunakan Kebugaran REST API, Anda memerlukan Akun Google. Jika sudah memiliki akun, Anda sudah siap. Sebaiknya Anda juga membuat Akun Google terpisah untuk tujuan pengujian.

Meminta client ID OAuth 2.0

Ikuti langkah-langkah berikut untuk meminta client ID OAuth 2.0 untuk Kebugaran API.

  1. Buka Konsol API Google.
  2. Pilih project atau buat yang baru. Gunakan project yang sama untuk versi Android dan REST aplikasi Anda.
  3. Klik Continue untuk mengaktifkan Fitness API.
  4. Klik Go to credentials.
  5. Klik New credentials, lalu pilih OAuth Client ID.
  6. Di bagian Jenis aplikasi, pilih Aplikasi web.
  7. Di bagian Asal JavaScript resmi, masukkan URL dasar situs tempat permintaan akan berasal (misalnya, https://developers.google.com adalah URL yang digunakan oleh OAuth Playground).
  8. Di bagian URI pengalihan yang sah, masukkan URL situs tempat respons akan ditangani (misalnya, https://developers.google.com/oauthplayground adalah URL yang digunakan oleh OAuth Playground).

  9. Klik Create. Client ID dan rahasia OAuth 2.0 baru Anda akan muncul dalam daftar ID untuk project Anda. Client ID OAuth 2.0 adalah string karakter, seperti ini:

    780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com

Mencoba REST API di OAuth Playground

OAuth Playground adalah cara termudah untuk memahami Fitness REST API dengan mengirimkan permintaan HTTP dan mengamati responsnya sebelum Anda menulis kode klien apa pun.

Untuk memberikan otorisasi Kebugaran REST API di OAuth Playground:

  1. Buka OAuth Playground.
  2. Di bagian Step 1 Select & authorization APIs, luaskan Fitness v1 dan pilih cakupan Kebugaran yang akan digunakan.
  3. Klik tombol Authorize APIs, pilih project Konsol API Google yang akan digunakan, lalu klik Allow saat diminta. Anda akan dapat mengakses dan mengubah data yang terkait dengan akun Konsol API Google yang dipilih.
  4. Klik tombol Kode otorisasi Exchange untuk token. Playground OAuth otomatis menyertakan header ini di header permintaan Authorization: saat Anda mengirimkan permintaan HTTP. Perhatikan bahwa masa berlaku token akses akan berakhir setelah 60 menit (3.600 detik).

Mengirim permintaan HTTP

Contoh berikut menunjukkan cara mengirim permintaan HTTP untuk mencantumkan semua sumber data yang tersedia, dan untuk membuat sumber data baru. Untuk Kebugaran REST API, format URI adalah:

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

Untuk menampilkan daftar semua sumber data yang tersedia:

  1. Pada Metode HTTP, pilih GET.
  2. Di URI Permintaan, masukkan https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Klik Send the request.

Permintaan dan respons muncul di sisi kanan halaman. Jika permintaan berhasil, respons akan menampilkan sumber data dari contoh sebelumnya dalam format JSON.

Untuk membuat sumber data:

  1. Pada HTTP Method, pilih POST.
  2. Di URI Permintaan, masukkan https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Klik Masukkan isi permintaan.

  4. Di jendela Request Body, salin dan tempel JSON berikut:

    {
  "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. Di jendela Request Body, klik Close.

  6. Klik Send the request.

Permintaan dan respons muncul di sisi kanan halaman. Permintaan tersebut menyertakan token akses OAuth di header Authorization:

Authorization: Bearer ya29.OAuthTokenValue

Jika permintaan berhasil, baris pertama respons adalah:

HTTP/1.1 200 OK

Menggunakan cURL untuk mengakses Fit REST API

Anda dapat menggunakan alat command line cURL untuk mengakses Fit REST API. Anda akan memerlukan token akses OAuth untuk membuat permintaan menggunakan cURL (lihat instructions sebelumnya). Perhatikan bahwa masa berlaku token akses berakhir setelah satu jam. Contoh berikut menunjukkan skrip bash sederhana untuk mencantumkan semua sumber data.

#!/bin/bash
ACCESS_TOKEN=""
curl \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  https://www.googleapis.com/fitness/v1/users/me/dataSources

Langkah berikutnya

Untuk mempelajari REST API lebih lanjut, lihat halaman berikut: