Saat aplikasi Anda meminta data publik, permintaan ini tidak perlu diberi otorisasi, tetapi harus disertai dengan ID, seperti kunci API.
Aplikasi Anda harus mengidentifikasi dirinya sendiri setiap kali mengirim permintaan ke Search API Pustaka Pengetahuan Google, dengan menyertakan kunci API bersama setiap permintaan.
Mendapatkan dan menggunakan kunci API
Untuk mendapatkan kunci API:
- Buka halaman Credentials di Konsol API.
-
API ini mendukung dua jenis kredensial.
Buat kredensial apa pun yang sesuai untuk project Anda:
-
OAuth 2.0: Setiap kali aplikasi Anda meminta data pengguna pribadi, aplikasi harus mengirimkan token OAuth 2.0 bersama dengan permintaan tersebut. Aplikasi Anda terlebih dahulu mengirimkan client ID dan, mungkin, rahasia klien untuk mendapatkan token. Anda dapat membuat kredensial OAuth 2.0 untuk aplikasi web, akun layanan, atau aplikasi yang diinstal.
Catatan: Karena API ini tidak memiliki metode apa pun yang memerlukan otorisasi OAuth 2.0, Anda mungkin hanya perlu mendapatkan kunci API, yang dijelaskan di bawah. Namun, jika aplikasi Anda memanggil API lain yang memerlukan otorisasi pengguna, Anda tetap memerlukan kredensial OAuth 2.0.
Untuk informasi selengkapnya, lihat Dokumentasi OAuth 2.0.
-
Kunci API: Permintaan yang tidak menyediakan token OAuth 2.0 harus mengirim kunci API. Kunci tersebut mengidentifikasi project Anda dan memberikan akses, kuota, dan laporan API.
API ini mendukung beberapa jenis pembatasan pada kunci API. Jika kunci API yang Anda butuhkan belum ada, buat kunci API di Konsol dengan mengklik Create credentials > API key. Anda dapat membatasi kunci sebelum menggunakannya dalam produksi dengan mengklik Restrict key dan memilih salah satu Restrictions.
-
Untuk menjaga keamanan kunci API Anda, ikuti praktik terbaik untuk menggunakan kunci API dengan aman.
Setelah memiliki kunci API, aplikasi Anda dapat menambahkan parameter kueri key=yourAPIKey ke semua URL permintaan.
Kunci API aman untuk disematkan dalam URL; tidak memerlukan encoding apa pun.