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 Anda mengonfigurasi yang dimulai dengan Konfigurasi hasil untuk penelusuran . Perhatikan bahwa Anda tidak dapat menyesuaikan gaya widget penelusuran di halaman web Anda.

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 sebelumnya yang benar. Token autentikasi digunakan untuk melakukan panggilan API atas nama pengguna atau akun layanan Anda. 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.

  Catatan: Jika Anda memilih kumpulan tenaga kerja untuk mengontrol akses ke data aplikasi, dapatkan token berumur pendek untuk workforce identity federation.

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

Menambahkan widget yang menggunakan token otorisasi

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

   Pembuat Agen

2. Klik nama aplikasi yang ingin Anda edit.

3. Klik Integration.

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 diberikan di bagian Salin kode berikut ke aplikasi web Anda.

10. Di codebase Anda, buat token otorisasi.

    Catatan: Jika Anda memilih kumpulan tenaga kerja untuk mengontrol akses ke data aplikasi, dapatkan token berumur pendek untuk workforce identity federation.

11. Untuk meneruskan token otorisasi ke widget Anda, gunakan cuplikan kode kedua, "// Set authorization token", yang diberikan dalam bagian Salin kode berikut ke bagian 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 habis.

Menambahkan widget yang memiliki akses publik

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

   Pembuat Agen

2. Klik nama aplikasi yang ingin Anda edit.

3. Klik Integration.

4. Klik tab Widget.

5. Pilih Public Access 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 ingin widget hanya 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.