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.
- Buka Konsol API Google.
- Pilih project atau buat yang baru. Gunakan project yang sama untuk versi Android dan REST aplikasi Anda.
- Klik Continue untuk mengaktifkan Fitness API.
- Klik Go to credentials.
- Klik New credentials, lalu pilih OAuth Client ID.
- Di bagian Jenis aplikasi, pilih Aplikasi web.
- 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). - 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). 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:
- Buka OAuth Playground.
- Di bagian Step 1 Select & authorization APIs, luaskan Fitness v1 dan pilih cakupan Kebugaran yang akan digunakan.
- 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.
- 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:
- Pada Metode HTTP, pilih GET.
- Di URI Permintaan, masukkan
https://www.googleapis.com/fitness/v1/users/me/dataSources
- 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:
- Pada HTTP Method, pilih POST.
- Di URI Permintaan, masukkan
https://www.googleapis.com/fitness/v1/users/me/dataSources
- Klik Masukkan isi permintaan.
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" } }
Di jendela Request Body, klik Close.
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: