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 membahas 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 drop-down project di sebelah kanan "Google Cloud Console" lalu pilih PROJECT BARU.
  3. Masukkan nama di kolom Project Name.
  4. (Opsional) Klik Edit untuk mengubah Project ID. Anda tidak dapat mengubah ID ini setelah dibuat.
  5. Klik JELAJAHI 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 Google Cloud Console.
  2. Klik ENABLE APIS AND SERVICES.
  3. Cari 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 Buat kredensial.
  3. Masukkan nama di kolom Service account name.
  4. (Opsional) Edit ID akun layanan.
  5. Klik Buat dan lanjutkan.
  6. Klik Selesai untuk membuka daftar "Akun layanan".
  7. Klik email akun layanan baru Anda, lalu pilih tab Kunci.
  8. Klik ADD KEY > Create new key.
  9. Pilih JSON, lalu klik Buat. 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 Navigation menu > IAM & Admin > Service Accounts.
  3. Catat alamat email untuk akun layanan Anda. Anda memerlukan ini untuk menambahkan sumber data ke Cloud Search.

5. Menginisialisasi dukungan pihak ketiga

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

Untuk menginisialisasi dukungan pihak ketiga:

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

  3. Jalankan perintah curl ini, dengan mengganti [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 saat 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.