Mengonfigurasi akses ke Google Cloud Search API

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

1. Membuat project API

Untuk mengaktifkan API, buat project Google Cloud terlebih dahulu. Project ini adalah dasar untuk menggunakan layanan Google Cloud, mengelola API, dan menetapkan izin.

  1. Buka Konsol Google Cloud.
  2. Klik menu drop-down project di sebelah kanan "Konsol Google Cloud" dan pilih PROJECT BARU.
  3. Masukkan nama di kolom Nama Project.
  4. (Opsional) Klik Edit untuk mengubah Project ID. Anda tidak dapat mengubah ID ini setelah pembuatan.
  5. Klik TELUSURI untuk memilih lokasi, lalu klik Pilih.
  6. Klik Buat. Project biasanya siap dalam hitungan menit.

Untuk mengetahui informasi selengkapnya, lihat Membuat dan Mengelola Project.

2. Mengaktifkan API

Aktifkan Cloud Search API dan buat akun layanan untuk mendapatkan kredensial.

  1. Pilih project baru Anda dari menu drop-down di banner konsol Google Cloud.
  2. Klik ENABLE APIS AND SERVICES.
  3. Telusuri dan pilih Google Cloud Search API.
  4. Klik Enable.

Untuk mengetahui informasi selengkapnya, lihat Mengelola API di konsol Google Cloud.

3. Membuat kredensial akun layanan

  1. Di konsol Google Cloud, klik Credentials di navigasi sebelah kiri.
  2. Pilih akun layanan dari menu drop-down Create credentials.
  3. Masukkan nama di kolom Nama akun layanan.
  4. (Opsional) Edit ID akun layanan.
  5. Klik Create and continue.
  6. Klik Done untuk membuka daftar "Service accounts".
  7. Klik email akun layanan baru Anda, lalu pilih tab Keys.
  8. Klik ADD KEY > Create new key.
  9. Pilih JSON dan klik Create. Kunci pribadi akan didownload ke komputer Anda.

Untuk mengetahui informasi selengkapnya, lihat Akun layanan.

4. Mengidentifikasi email akun layanan

  1. Di konsol Google Cloud, pilih project Anda.
  2. Klik menu navigasi > IAM & Admin > Akun Layanan.
  3. Catat alamat email untuk akun layanan Anda. Anda memerlukan alamat email ini untuk menambahkan sumber data ke Cloud Search.

5. Menginisialisasi dukungan pihak ketiga

Inisialisasi dukungan pihak ketiga untuk Google Cloud Search sebelum Anda memanggil Cloud Search API lainnya.

Untuk menginisialisasi dukungan pihak ketiga:

  1. Buat kredensial aplikasi web di project platform Cloud Search Anda. Lihat Membuat kredensial. Anda memerlukan client ID dan rahasia klien.
  2. Dapatkan token akses menggunakan OAuth 2.0 Playground:
    1. Klik OAuth 2.0 Configuration (ikon setelan) dan centang Use your own OAuth credentials.
    2. Masukkan client ID dan rahasia klien Anda.
    3. Di kolom cakupan, masukkan https://www.googleapis.com/auth/cloud_search.settings dan klik Authorize APIs.
    4. Klik Exchange authorization code for tokens.

  3. Jalankan perintah curl ini, ganti [YOUR_ACCESS_TOKEN] dengan token Anda:

    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 menyertakan operation. Jika gagal, hubungi dukungan Cloud Search.

  4. Gunakan operations.get untuk memverifikasi inisialisasi:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    Inisialisasi selesai jika done adalah true.

Langkah Berikutnya

  1. Untuk menggunakan Cloud Search dengan repositori non-Google seperti Microsoft® SharePoint®, Anda harus membuat sumber data. Lihat Menambahkan sumber data untuk penelusuran.
  2. Setelah menyiapkan sumber data, buat dan daftarkan skema. untuk mengidentifikasi cara Cloud Search merepresentasikan data Anda. cara Cloud Search merepresentasikan data.