Menambahkan widget penelusuran ke halaman web

Halaman ini menjelaskan cara menambahkan fungsi penelusuran ke situs menggunakan widget penelusuran.

Sebelum memulai

Sebelum menambahkan widget penelusuran ke halaman web, pastikan untuk mengonfigurasi widget penelusuran, dimulai dengan Mengonfigurasi hasil untuk widget penelusuran. Perhatikan bahwa Anda tidak dapat menyesuaikan gaya widget penelusuran di halaman web.

Prosedur

Prosedur untuk menambahkan widget penelusuran ke halaman web Anda berbeda-beda, bergantung pada jenis otorisasi yang Anda pilih:

• Token otorisasi: Widget menggunakan token JWT atau OAuth yang disediakan oleh codebase Anda. Anda harus memiliki server sendiri yang dapat digunakan untuk membuat token. Token autentikasi digunakan untuk melakukan panggilan API atas nama akun pengguna atau layanan. Saat membuat token autentikasi, gunakan cakupan OAuth https://www.googleapis.com/auth/cloud-platform.

  • Untuk interaksi server ke server dengan akun layanan: Lihat Menggunakan OAuth 2.0 untuk Aplikasi Server ke Server dalam dokumentasi otorisasi.

  • Untuk aplikasi web JavaScript: Lihat OAuth 2.0 untuk Aplikasi Web Sisi Klien dalam dokumentasi otorisasi.

• Akses publik: Widget tidak akan membatasi siapa yang dapat mendapatkan hasil dari kueri penelusuran.

Menambahkan widget yang menggunakan token otorisasi

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Klik nama aplikasi yang ingin Anda edit.

3. Klik Integrasi.

4. Klik tab Widget.

5. Pilih Berbasis JWT atau OAuth sebagai jenis otorisasi widget.

6. Tentukan nama domain untuk halaman widget:

   1. Masukkan nama domain untuk halaman tempat widget akan muncul.

      Misalnya, jika Anda akan menyalin widget ke halaman example.com/ai.html dan cymbal.example.com/search.html, masukkan example.com sebagai domain. Jika Anda hanya ingin widget berfungsi di halaman di subdomain, masukkan cymbal.example.com.

      Jika Anda ingin menguji widget di localhost, masukkan localhost.

   2. Klik Tambahkan.

7. Ulangi langkah 6 untuk setiap domain tempat widget akan muncul.

8. Klik Simpan.

9. Salin cuplikan kode yang disediakan di bagian Salin kode berikut ke aplikasi web Anda.

10. Di codebase Anda, buat token otorisasi.

11. Untuk meneruskan token otorisasi ke widget, gunakan cuplikan kode kedua, "// Set authorization token", yang disediakan di bagian Salin kode berikut ke aplikasi web Anda dan ganti teks <JWT or OAuth token provided by you backend> dengan token otorisasi Anda.

12. Tetapkan token baru secara berkala dengan mengulangi langkah sebelumnya sebelum masa berlaku token saat ini berakhir.

Menambahkan widget yang memiliki akses publik

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Klik nama aplikasi yang ingin Anda edit.

   Untuk akses publik, pastikan aplikasi penelusuran tidak dikaitkan dengan penyimpanan data apa pun dalam kontrol akses.

3. Klik Integrasi.

4. Klik tab Widget.

5. Pilih Akses Publik sebagai jenis otorisasi widget.

6. Tentukan nama domain untuk halaman widget:

   1. Masukkan nama domain untuk halaman tempat widget akan muncul.

      Misalnya, jika Anda akan menyalin widget ke halaman example.com/ai.html dan cymbal.example.com/search.html, masukkan example.com sebagai domain. Jika Anda hanya ingin widget berfungsi di halaman di subdomain, masukkan cymbal.example.com.

      Jika Anda ingin menguji widget di localhost, masukkan localhost.

   2. Klik Tambahkan.

7. Ulangi langkah 6 untuk setiap domain tempat widget akan muncul.

8. Klik Simpan.

9. Salin cuplikan kode yang disediakan di bagian Salin kode berikut ke aplikasi web Anda, lalu tempel cuplikan kode ke halaman web Anda.