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 terlebih dahulu membuat project Google Cloud. 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 "New Project" akan muncul.

  4. Masukkan nama project di kolom Project Name.

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

  6. Untuk melihat lokasi project, klik LIHAT.

  7. Klik lokasi untuk project Anda dan 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 perlu 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 Google Cloud Console dan pilih project yang baru dibuat.
  2. Klik ENABLE APIS AND SERVICE. Halaman "Welcome to API Library" akan muncul.
  3. Buka API Google Cloud Search.
  4. Klik Enable. Halaman "Ringkasan" akan muncul.

Untuk informasi lebih lanjut cara mengaktifkan dan menonaktifkan API, lihat Mengelola API di Google Cloud Console

3. Membuat kredensial akun layanan

  1. Di Google Cloud Console, klik Credentials 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 Nama akun layanan.
  4. (opsional) Edit ID akun layanan.
  5. Klik Create. Layar "Izin akun layanan" akan muncul.
  6. Klik Lanjutkan. Layar "Beri 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.
  8. Klik Tutup.

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

4. Identifikasi alamat email

  1. Dari Google Cloud Console, pilih project yang Anda buat di bagian atas halaman.
  2. Klik Menu navigasi di sebelah kiri banner Google Cloud Console.
  3. Klik IAM dan Admin > Akun layanan.
  4. Dalam daftar, di bagian "ID akun layanan", catat alamat email yang dihasilkan yang mengidentifikasi akun layanan yang Anda konfigurasikan. 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 petunjuk tentang cara membuat kredensial aplikasi web, lihat Membuat kredensial. Setelah menyelesaikan langkah ini, Anda seharusnya memiliki client ID dan file rahasia klien.

  2. Gunakan playground OAuth 2 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 Authorize. Playground OAuth 2 menampilkan kode otorisasi.
    5. Klik Kode otorisasi Exchange untuk token. Token ditampilkan.

  3. Untuk 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 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 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 diinisialisasi, inisialisasi pihak ketiga 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.