Mengonfigurasi akses ke REST API Google Cloud Search

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

1. Membuat project API

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

  1. Buka Google Cloud Console.

  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. ID project tidak dapat diubah setelah dibuat. Jadi, pilih yang sesuai dengan kebutuhan Anda sepanjang waktu.

  6. Untuk menjelajahi lokasi project, klik BROWSE.

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

  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 REST API Cloud Search 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 Anda buat.
  2. Klik AKTIFKAN API DAN LAYANAN. 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 Google Cloud Console

3 Membuat kredensial akun layanan

  1. Di Cloud Platform Console, klik Kredensial 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 Nama akun layanan.
  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 BUAT KUNCI dan klik Selesai. Dialog "Kunci pribadi yang disimpan ke komputer" akan muncul dan salinan kunci pribadi yang 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 Cloud Platform Console, pilih project yang sudah dibuat 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 dibuat 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.

Guna menginisialisasi 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 cara membuat kredensial aplikasi web, lihat Membuat kredensial. Setelah menyelesaikan langkah ini, Anda akan memiliki ID rahasia dan file klien.

  2. Gunakan Google Play 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. Taman bermain OAuth 2 menampilkan kode otorisasi.
    5. Klik Kode otorisasi Exchange 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 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 sudah 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
    

    Jika sudah 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.