Memulai REST API

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

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

Dapatkan Akun Google

Untuk menggunakan Fitness REST API, Anda membutuhkan Akun Google. Jika Anda sudah memiliki akun, berarti Anda sudah siap. Anda juga dapat membuat Akun Google terpisah untuk tujuan pengujian.

Meminta ID klien OAuth 2.0

Ikuti langkah berikut untuk meminta client ID OAuth 2.0 untuk Fitness API.

  1. Buka Konsol API Google.
  2. Pilih project, atau buat project baru. Gunakan project yang sama untuk versi Android dan REST aplikasi Anda.
  3. Klik Lanjutkan untuk mengaktifkan Fitness API.
  4. Klik Buka kredensial.
  5. Klik Kredensial baru, lalu pilih Client ID OAuth.
  6. Di bagian Application type, pilih Web application.
  7. Di bagian Asal JavaScript yang sah, masukkan URL dasar situs tempat permintaan berasal (misalnya https://developers.google.com adalah URL yang digunakan oleh OAuth Playground).
  8. Di bagian Authorized redirect URI, masukkan URL situs tempat respons akan ditangani (misalnya https://developers.google.com/oauthplayground adalah URL yang digunakan oleh OAuth Playground).

  9. Klik Create. Rahasia dan ID Klien OAuth 2.0 baru Anda 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 membiasakan diri dengan REST API Fitness dengan mengirimkan permintaan HTTP dan mengamati respons sebelum Anda menulis kode klien.

Untuk mengizinkan Fitness REST API di OAuth Playground:

  1. Buka OAuth Playground.
  2. Pada Step 1 Select & authorize APIs, luaskan Fitness v1, lalu pilih cakupan Kebugaran yang akan digunakan.
  3. Klik tombol Authorize APIs, pilih project Konsol API Google yang akan digunakan, lalu klik Allow jika 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. OAuth Playground otomatis menyertakan header ini dalam 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 membuat sumber data baru. Untuk Fitness REST API, format URI-nya adalah:

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

Untuk mencantumkan semua sumber data yang tersedia:

  1. Pada HTTP Method, pilih GET.
  2. Di Request URI, 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 Request URI, masukkan https://www.googleapis.com/fitness/v1/users/me/dataSources
  3. Klik Masukkan isi permintaan.

  4. Di jendela Isi Permintaan, 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 Isi Permintaan, klik Tutup.

  6. Klik Send the request.

Permintaan dan respons muncul di sisi kanan halaman. Permintaan tersebut menyertakan token akses OAuth dalam 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 memerlukan token akses OAuth untuk membuat permintaan menggunakan cURL (lihat petunjuk 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: