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 membuat project Google Cloud terlebih dahulu. Ini project membentuk dasar untuk membuat, mengaktifkan, dan menggunakan semua layanan Google Cloud layanan IT, termasuk mengelola API, mengaktifkan penagihan, menghapus kolaborator, dan mengelola izin.

  1. Buka Konsol Google Cloud.

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

  3. Klik NEW PROJECT. "New Project" 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 JELAJAHI.

  7. Klik lokasi project Anda, lalu klik Select.

  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 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 konsol Google Cloud dan pilih project yang baru Anda buat.
  2. Klik ENABLE APIS AND SERVICES. Halaman "Welcome to API Library" halaman muncul.
  3. Buka API Google Cloud Search.
  4. Klik Aktifkan. "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 Credentials di navigasi sebelah kiri. Halaman Kredensial akan muncul.
  2. Dari menu drop-down Create credentials, pilih Akun layanan. Tujuan "Buat akun layanan" akan muncul.
  3. Masukkan nama di kolom Service account name.
  4. (opsional) Edit ID akun layanan.
  5. Klik Buat. "Izin akun layanan" muncul.
  6. Klik Lanjutkan. Kolom "Beri pengguna akses ke akun layanan ini" layar muncul.
  7. Klik CREATE KEY dan klik Done. "Kunci pribadi disimpan ke komputer" dialog muncul dan salinan kunci pribadi diunduh ke komputer Anda
  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 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 email yang dibuat yang mengidentifikasi akun layanan yang dikonfigurasi. Alamat email ini digunakan saat menambahkan sumber data ke Cloud Search.

5. Melakukan inisialisasi dukungan pihak ketiga

Sebelum dapat memanggil API Cloud Search lainnya, Anda harus melakukan inisialisasi yang sama 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. Untuk petunjuk cara membuat aplikasi web kredensial, lihat Buat kredensial. Setelah menyelesaikan langkah ini, Anda akan memiliki file client ID dan file rahasia klien.

  2. Gunakan Playground OAuth 2 Google untuk mendapatkan token akses:

    1. Klik setelan, lalu centang User your own auth credentials.
    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 Exchange otorisasi kode untuk token. Token ditampilkan.
  3. Guna menginisialisasi dukungan pihak ketiga untuk Cloud Search, gunakan curl berikut perintah. 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 berisi 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
    

    Ketika inisialisasi pihak ketiga selesai, ini akan berisi kolom done 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.