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, menambah dan menghapus kolaborator, serta mengelola izin.

  1. Buka Konsol Google Cloud.

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

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

  4. Masukkan nama project di kolom Nama Project.

  5. (opsional) Klik Edit untuk mengedit Project ID. Project ID tidak dapat diubah setelah project dibuat. Jadi, pilih ID 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 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 membuka project yang baru dibuat, klik ikon di sebelah kanan banner konsol Google Cloud, lalu pilih project yang baru dibuat.
  2. Klik AKTIFKAN API DAN LAYANAN. Halaman "Selamat datang di Library API" 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 Kredensial di navigasi sebelah kiri. Halaman Kredensial akan muncul.
  2. Dari menu drop-down Create credentials, pilih Service account. Halaman "Buat akun layanan" 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 BUAT KUNCI dan klik Selesai. Dialog "Kunci pribadi disimpan ke komputer Anda" akan muncul dan salinan kunci pribadi akan didownload ke komputer.
  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 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 "ID akun layanan", catat alamat email yang dihasilkan dan mengidentifikasi akun layanan yang Anda konfigurasi. Alamat email ini digunakan saat menambahkan sumber data ke Cloud Search.

5. Menginisialisasi dukungan pihak ketiga

Sebelum dapat memanggil Cloud Search API lainnya, Anda harus menginisialisasi 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, lihat Membuat kredensial. Setelah menyelesaikan langkah ini, Anda seharusnya memiliki file client ID dan rahasia klien.

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

    1. Klik setelan dan 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 authorization code for tokens. 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 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 memuat instance operation. Contoh:

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

    Jika gagal, 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, ini 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.