Prasyarat

Sebelum dapat memulai coding aplikasi klien pertama Anda, ada beberapa hal yang harus dilakukan, jika Anda belum melakukannya.

Membuat Akun Google

Anda memerlukan Akun Google untuk membuat project di Konsol API Google. Jika sudah memiliki akun, Anda sudah siap.

Sebaiknya buat Akun Google terpisah untuk tujuan pengujian.

Membuat project untuk klien Anda

Sebelum dapat mengirim permintaan ke Google Knowledge Graph Search API, Anda harus memberi tahu Google tentang klien Anda dan mengaktifkan akses ke API tersebut. Anda dapat melakukannya menggunakan Konsol API Google untuk membuat project, yang merupakan kumpulan bernama untuk setelan dan informasi akses API, lalu mendaftarkan aplikasi Anda.

Untuk mulai menggunakan Search API Pustaka Pengetahuan Google, Anda harus menggunakan alat penyiapan terlebih dahulu, yang memandu Anda dalam membuat project di Konsol API Google, mengaktifkan API, dan membuat kredensial.

Jika belum melakukannya, buat kunci API aplikasi Anda dengan mengklik Create credentials > API key. Selanjutnya, cari kunci API Anda di bagian kunci API.

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, hal 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. Ini menetapkan resource melalui URI yang unik secara global dengan bentuk 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 Search API Google Knowledge Graph

Operasi Search API Pustaka Pengetahuan Google dipetakan langsung ke kata kerja HTTP REST.

Format spesifik untuk URI Search API Pustaka Pengetahuan Google adalah:

https://kgsearch.googleapis.com/v1/entities:search?query=your_query&parameters

Kumpulan lengkap URI yang digunakan untuk setiap operasi yang didukung dalam API diringkas dalam dokumen Referensi Search API Pustaka Pengetahuan Google.

Mempelajari dasar-dasar JSON

Search API Pustaka Pengetahuan Google 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.