Sebelum dapat memulai coding aplikasi klien pertama Anda, ada beberapa hal yang harus dilakukan, jika Anda belum melakukannya.
Membuat project untuk klien Anda
Sebelum dapat mengirim permintaan, Anda perlu memberi tahu Google tentang klien Anda dan mengaktifkan akses ke API. Caranya adalah dengan menggunakan Konsol API Google untuk membuat project, yang merupakan kumpulan setelan dan informasi akses API yang bernama, dan mendaftarkan aplikasi Anda.
Untuk mulai menggunakan Android Over The Air API, Anda harus menggunakan alat penyiapan terlebih dahulu, yang memandu Anda menyelesaikan pembuatan project di Konsol API Google, mengaktifkan API, dan membuat kredensial.
Mengizinkan project
Android Over The Air API hanya tersedia untuk project yang diizinkan. Jika project tidak diizinkan, Anda akan menerima 404 error saat mencoba menggunakannya.
Agar diizinkan, kirim email ke Google TAM untuk mengizinkan project ID baru Anda.
Project ID dapat ditemukan di Cloud Dashboard. Lihat dokumen bantuan ini untuk informasi selengkapnya.
Perhatikan bahwa ID project idealnya harus dalam format ini {company}-gota-api-{angka}
Setelah Anda mendapatkan izin, enable Android Over The Air API untuk project Anda dan lihat petunjuk otorisasi untuk mengetahui detail tentang cara mengaksesnya.
Perhatikan bahwa hanya project ID yang Anda berikan yang dapat menggunakan Android Over The Air API. Sebaiknya buat akun layanan (seperti yang dijelaskan dalam otorisasi) untuk penggunaan API daripada menggunakan akun pribadi apa pun.
Mencoba Dasbor Android Over The Air
Dokumentasi API ini mengasumsikan bahwa Anda telah menggunakan Dasbor Android Over The Air, dan memahami konsep pemrograman web dan format data web.
Jika Anda belum pernah menggunakan Dasbor Android Over The Air, cobalah antarmuka pengguna sebelum mulai membuat kode.
Mempelajari dasar-dasar REST
Ada dua cara untuk memanggil API:
- Mengirim permintaan HTTP dan mengurai respons.
- Menggunakan library klien.
Jika memutuskan untuk tidak menggunakan library klien, Anda harus memahami dasar-dasar REST.
REST adalah gaya arsitektur software yang memberikan pendekatan yang praktis dan konsisten untuk meminta dan memodifikasi data.
Istilah REST adalah singkatan dari "Representational State Transfer". Dalam konteks Google API, ini mengacu pada penggunaan kata kerja HTTP untuk mengambil dan mengubah representasi data yang disimpan oleh Google.
Dalam sistem RESTful, resource disimpan di penyimpanan data; klien mengirim permintaan agar server melakukan tindakan tertentu (seperti membuat, mengambil, memperbarui, atau menghapus resource), dan server melakukan tindakan dan mengirim respons, sering kali dalam bentuk representasi resource yang ditentukan.
Di RESTful API Google, klien menentukan tindakan menggunakan kata kerja HTTP seperti POST, GET, PUT, atau DELETE. Class ini menetapkan resource melalui URI unik global dengan form berikut:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Karena semua resource API memiliki URI unik yang dapat diakses HTTP, REST memungkinkan caching data dan dioptimalkan untuk berfungsi dengan infrastruktur terdistribusi web.
Anda dapat memperoleh manfaat dari definisi metode dalam dokumentasi standar HTTP 1.1; dokumentasi tersebut menyertakan spesifikasi untuk GET, POST, PUT, dan DELETE.
REST di Android Over The Air API
Operasi Android Over The Air API dipetakan langsung ke kata kerja HTTP REST.
Format khusus untuk URI Android Over The Air API adalah:
https://www.googleapis.com/android/over-the-air/v1/resourcePath?parameters
Kumpulan lengkap URI yang digunakan untuk tiap operasi yang didukung dalam API diringkas dalam dokumen Referensi Android Over The Air API.
Mempelajari dasar-dasar JSON
Android Over The Air API menampilkan data dalam format JSON.
JSON (JavaScript Object Notation) adalah format data umum independen bahasa yang memberikan representasi teks sederhana untuk struktur data arbitrer. Untuk informasi selengkapnya, lihat json.org.