Mengonfigurasi akses ke Google Cloud Search API

Anda harus mengonfigurasi akses ke Google Cloud Search API sebelum dapat menggunakan API ini secara langsung atau 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, menambah 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 NEW PROJECT. Layar "New Project" akan muncul.

  4. Masukkan nama project di kolom Project Name.

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

  6. Untuk menjelajahi lokasi project, klik JELAJAHI.

  7. Klik lokasi project Anda, lalu klik Select.

  8. Klik Create. 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, lalu pilih project yang baru dibuat.
  2. Klik ENABLE APIS AND SERVICES. Halaman "Welcome to API Library" akan muncul.
  3. Buka API Google Cloud Search.
  4. Klik Enable. Halaman "Ringkasan" akan muncul.

Untuk informasi lebih lanjut tentang cara 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 Create credentials, pilih Service account. Halaman "Create service account" akan muncul.
  3. Masukkan nama di kolom Service account name.
  4. (opsional) Edit ID akun layanan.
  5. Klik Create. Layar "Izin akun layanan" akan muncul.
  6. Klik Continue. Layar "Berikan pengguna akses ke akun layanan ini" akan muncul.
  7. Klik CREATE KEY dan klik Done. Dialog "Kunci pribadi disimpan ke komputer Anda" akan muncul dan salinan kunci pribadi akan didownload ke komputer Anda.
  8. Klik Close.

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

4. Identifikasi alamat email

  1. Dari Konsol Google Cloud, pilih project yang sudah Anda buat 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 "Service account ID", catat alamat email yang dihasilkan 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 API Cloud Search lainnya, Anda harus melakukan inisialisasi dukungan pihak ketiga untuk Google Cloud Search.

Untuk melakukan inisialisasi dukungan pihak ketiga untuk Cloud Search:

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

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

    1. Klik setelan, lalu centang User your own auth credentials.
    2. Masukkan client ID dan rahasia klien dari langkah 1.
    3. Klik Close.
    4. Di kolom cakupan, ketik https://www.googleapis.com/auth/cloud_search.settings, lalu klik Authorize. Playground OAuth 2 menampilkan kode otorisasi.
    5. Klik Exchange otorisasi kode untuk token. Token ditampilkan.

  3. Guna menginisialisasi dukungan pihak ketiga untuk Cloud Search, gunakan perintah curl berikut. Pastikan untuk mengganti [YOUR_ACCESS_TOKEN] dengan token yang diperoleh pada 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 memuat 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 telah 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

    Saat inisialisasi pihak ketiga selesai, inisialisasi tersebut 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.