Mengonfigurasi akses ke Google Cloud Search API

Anda harus mengonfigurasi akses ke Google Cloud Search API sebelum dapat menggunakan API ini, baik secara langsung maupun melalui SDK. Dokumen ini membahas langkah-langkah yang diperlukan untuk menggunakan REST API Google Cloud Search API.

1. Membuat project API

Untuk mengaktifkan API, Anda harus membuat project Google Cloud terlebih dahulu. Project ini membentuk dasar untuk membuat, mengaktifkan, dan menggunakan semua layanan Google Cloud, termasuk mengelola API, mengaktifkan penagihan, menambahkan dan menghapus kolaborator, serta mengelola izin.

  1. Buka Konsol Google Cloud.

  2. Di bagian atas halaman, klik di sebelah kanan "Konsol Google Cloud". Dialog yang mencantumkan project saat ini akan muncul.

  3. Klik PROJECT BARU. Layar "Project Baru" akan muncul.

  4. Masukkan nama project di kolom Project Name.

  5. (opsional) Klik Edit untuk mengedit ID Project. ID project tidak dapat diubah setelah dibuat. Jadi, pilih yang sesuai dengan kebutuhan Anda sepanjang waktu.

  6. Untuk menjelajahi lokasi project, klik JELAJAHI.

  7. Klik lokasi untuk project Anda, lalu klik Select.

  8. Klik Buat. Konsol akan membuka halaman Dashboard. Project dibuat dalam beberapa menit.

Untuk informasi lebih lanjut tentang membuat dan mengelola project, lihat Membuat dan Mengelola Project .

2. Mengaktifkan API

Anda harus mengaktifkan Google Cloud Search API dan membuat akun layanan untuk mendapatkan kredensial.

  1. Untuk memastikan Anda berada di project yang baru dibuat, klik ikon di sebelah kanan banner konsol Google Cloud dan pilih project yang baru dibuat.
  2. Klik ENABLE APIS AND SERVICES. Halaman "Selamat datang di Library API" akan muncul.
  3. Buka API Google Cloud Search.
  4. Klik Aktifkan. Halaman "Ringkasan" akan muncul.

Untuk informasi lebih lanjut tentang mengaktifkan dan menonaktifkan API, lihat Mengelola API di konsol Google Cloud

3. Membuat kredensial akun layanan

  1. Di konsol Google Cloud, klik Credentials di navigasi sebelah kiri. Halaman Kredensial akan muncul.
  2. Dari menu drop-down Buat kredensial, pilih Akun layanan. Halaman "Buat akun layanan" akan muncul.
  3. Masukkan nama di kolom Service account name.
  4. (opsional) Edit ID akun layanan.
  5. Klik Buat. Layar "Izin akun layanan" akan muncul.
  6. Klik Lanjutkan. Layar "Beri pengguna akses ke akun layanan ini" akan muncul.
  7. Klik CREATE KEY, lalu klik Done. Dialog "Kunci pribadi disimpan ke komputer Anda" akan muncul dan salinan kunci pribadi akan didownload ke komputer Anda.
  8. Klik Tutup.

Untuk informasi lebih lanjut tentang akun layanan, lihat Akun Layanan, aplikasi web, dan aplikasi yang diinstal

4. Mengidentifikasi alamat email

  1. Dari konsol Google Cloud, pilih project yang sudah dibuat di bagian atas halaman.
  2. Klik menu Navigasi di sebelah kiri banner konsol Google Cloud.
  3. Klik IAM dan Admin > Akun layanan.
  4. Dalam daftar, di bagian "ID Akun layanan", catat alamat email yang dibuat yang mengidentifikasi akun layanan yang dikonfigurasi. Alamat email ini digunakan saat menambahkan sumber data ke Cloud Search.

5. Melakukan inisialisasi dukungan pihak ketiga

Sebelum dapat memanggil Cloud Search API lainnya, Anda harus menginisialisasi dukungan pihak ketiga untuk Google Cloud Search.

Untuk menginisialisasi dukungan pihak ketiga untuk Cloud Search:

  1. Project Cloud Search Platform Anda berisi kredensial akun layanan. Namun, untuk melakukan inisialisasi dukungan pihak ketiga, Anda harus membuat kredensial aplikasi web. Untuk petunjuk cara membuat kredensial aplikasi web, lihat Membuat kredensial. Setelah menyelesaikan langkah ini, Anda akan memiliki file client ID dan rahasia klien.

  2. Gunakan OAuth 2 playground Google untuk mendapatkan token akses:

    1. Klik setelan dan centang Gunakan kredensial autentikasi Anda sendiri.
    2. Masukkan client ID dan rahasia klien dari langkah 1.
    3. Klik Tutup.
    4. Di kolom cakupan, ketik https://www.googleapis.com/auth/cloud_search.settings, lalu klik Beri otorisasi. OAuth 2 Playground menampilkan kode otorisasi.
    5. Klik Exchange authorization code for tokens. Token akan ditampilkan.

  3. Untuk menginisialisasi dukungan pihak ketiga untuk Cloud Search, gunakan perintah curl berikut. Pastikan untuk mengganti [YOUR_ACCESS_TOKEN] dengan token yang diperoleh di langkah 2.

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    Jika berhasil, isi respons akan berisi instance operation. Contoh:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

    Jika tidak berhasil, hubungi dukungan Cloud Search.

  4. Gunakan operations.get untuk memverifikasi bahwa dukungan pihak ketiga diinisialisasi:

    curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    Setelah selesai, inisialisasi pihak ketiga akan berisi kolom done yang ditetapkan ke true. Contoh:

    {
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

Langkah Berikutnya

Berikut langkah yang harus Anda ambil selanjutnya:

  1. Jika ingin menggunakan Google Cloud Search dengan repositori data non-Google, seperti Microsoft® SharePoint®, Anda harus membuat sumber data. Untuk petunjuk tentang menambahkan sumber data, lihat Menambahkan sumber data untuk penelusuran .

  2. Setelah menetapkan sumber data, Anda dapat membuat dan mendaftarkan skema untuk mengidentifikasi cara Google Cloud Search merepresentasikan data dalam repositori.