Persyaratan

Sebelum Anda dapat mulai membuat kode aplikasi klien pertama, ada beberapa hal yang perlu dilakukan, jika Anda belum melakukannya.

Dapatkan Akun Google

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

Anda mungkin juga menginginkan Akun Google terpisah untuk tujuan pengujian.

Membuat project untuk klien Anda

Agar dapat mengirim permintaan ke API Penelusuran Grafik Pengetahuan Google, Anda perlu memberi tahu Google tentang klien dan mengaktifkan akses ke API. Anda melakukannya dengan menggunakan Konsol API Google untuk membuat project, yang merupakan kumpulan bernama setelan dan informasi akses API, dan mendaftarkan aplikasi Anda.

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

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

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 praktis dan konsisten untuk meminta serta memodifikasi data.

Istilah REST adalah singkatan dari "Representational State Transfer". Dalam konteks Google API, merujuk pada penggunaan kata kerja HTTP untuk mengambil dan memodifikasi 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 serta 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. Instance ini menentukan resource berdasarkan 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.

Sebaiknya lihat definisi metode dalam dokumentasi standar HTTP 1.1; definisi tersebut mencakup spesifikasi untuk GET, POST, PUT, dan DELETE.

REST di Google Knowledge Graph Search API

Operasi Google Knowledge Graph Search API dipetakan langsung ke kata kerja HTTP REST.

Format spesifik untuk URI Google Search Graph Search API adalah:

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

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

Mempelajari dasar-dasar JSON

Google Knowledge Graph Search 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 mendapatkan informasi lebih lanjut, lihat json.org.