Mulai Menggunakan REST API

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

Untuk menggunakan Fitness REST API, penting bagi Anda untuk memahami dasar-dasar Layanan web RESTful dan representasi JSON.

Membuat Akun Google

Untuk menggunakan Fitness REST API, Anda memerlukan Akun Google. Jika sudah memiliki akun, Anda sudah siap. Anda mungkin juga ingin 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 Fitness API.

  1. Buka Konsol API Google.
  2. Pilih project, atau buat project baru. Menggunakan project yang sama untuk Android dan REST aplikasi Anda.
  3. Klik Continue untuk mengaktifkan Fitness API.
  4. Klik Go to credentials.
  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 Buat. Client ID dan rahasia OAuth 2.0 Anda yang baru akan muncul dalam daftar ID untuk project Anda. ID Klien OAuth 2.0 adalah string karakter, sesuatu 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 respons sebelumnya Anda menulis kode klien.

Untuk mengizinkan Fitness REST API di OAuth Playground:

  1. Buka OAuth Playground.
  2. Di bagian Langkah 1, Pilih & otorisasi API, luaskan Fitness v1, lalu pilih cakupan Kebugaran untuk digunakan.
  3. Klik tombol Authorize APIs, pilih project Konsol API Google untuk gunakan, lalu klik Izinkan saat diminta. Anda akan dapat mengakses dan mengubah data yang terkait dengan akun Konsol API Google yang dipilih.
  4. Klik tombol Exchange authorization code for tokens. OAuth Playground secara otomatis menyertakan header ini di Authorization: header permintaan saat Anda mengirim permintaan HTTP. Perhatikan bahwa token akses akan kedaluwarsa setelah 60 menit (3600 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 REST adalah Kebugaran API, format URI adalah:

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

Untuk menampilkan daftar semua sumber data yang tersedia:

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

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

Untuk membuat sumber data:

  1. Di Metode HTTP, 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 akan muncul di sisi kanan halaman. Permintaan 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 memerlukan token akses OAuth untuk membuat permintaan menggunakan cURL (lihat petunjuk sebelumnya). Perhatikan bahwa token akses akan habis masa berlakunya setelah satu jam. Contoh berikut menunjukkan skrip {i>bash<i} 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: