Pelengkapan otomatis Cloud Search membantu pengguna dengan menyarankan kata saat pengguna mengetik kueri penelusuran. Misalnya, saran mungkin berupa kata-kata dari judul dokumen, operator penelusuran, nilai operator penelusuran, atau nama dan alamat email dari organisasi Google Workspace.
Autocomplete mengekstrak frasa dari judul dokumen yang diindeks dan, menggunakan
model n-gram,
menentukan saran untuk ditayangkan menggunakan Suggest API. Secara default, frasa dari judul dokumen akan ditampilkan dalam pelengkapan otomatis. Anda juga dapat menandai properti teks dan skema enum sebagai is_suggestable
untuk melengkapi otomatis nama dan nilai properti yang sesuai.
Suggest API memeriksa kueri penelusuran untuk menemukan petunjuk tentang bahasa kueri,
seperti bahasa Inggris atau Spanyol, dan memprioritaskan hasil yang sesuai. Kolom
languageCode
permintaan juga digunakan untuk meningkatkan saran khusus bahasa.
Contoh skenario
Misalnya, Anda memiliki sumber data berikut yang berisi data tentang film:
- Sumber data berisi 2 dokumen.
- Setiap dokumen memiliki judul (
ItemMetadata.title
) dan dua properti:genre
dancharacters
. - Dokumen pertama berjudul "Avengers Infinity War” bersama
genre=science fiction
dancharacters=Iron Man, Hulk
- Dokumen kedua berjudul "Harry Potter" dengan
genre=Adventure, Fantasy and
karakter=Hermione, Harry Potter`
Gambar 1 mengilustrasikan cara saran pelengkapan otomatis diekstrak dari judul dokumen, properti, dan nilai properti.
Dari dokumen 1, kami mengekstrak ngram (hingga trigram) “Avengers”, “Infinity”, “War”, “Avengers Infinity”, “Infinity War”, “Avengers Infinity War”. Demikian juga dari dokumen 2, kami menghasilkan "Harry", "Potter", "Harry Potter".
Saat membuat kueri sumber data ini, anggaplah pengguna mulai dengan mengetik "h". Saran yang ditampilkan kepada pengguna adalah:
- Anna
- Hermione
- Raksasa
- Harry Potter
Misalnya pengguna memilih saran pelengkapan otomatis “Hermione” dan tombol berikutnya dari pengguna adalah karakter "a". Saran pelengkapan otomatis yang ditampilkan kepada pengguna adalah:
- Petualangan Hermione
- Aksi Hermione
- Hermione Avengers
Pelengkapan otomatis mencoba menyelesaikan kata terakhir (atau ngram) yang sedang diketik. Dalam contoh sebelumnya, karakter ini hanya memperluas "a" menjadi "petualangan", "aksi", dan "avengers" karena tidak ada teks yang dimulai dengan "hermione a" bersamaan. Saran ini disebut saran ekor; yang otomatis melengkapi kata/n-gram terakhir yang diketik.
Pelengkapan otomatis Cloud Search menampilkan maksimum 5 saran dari konten dokumen dan 2 saran orang.
Secara default, frasa dari judul dokumen akan ditampilkan dalam pelengkapan otomatis. Properti skema harus ditandai secara eksplisit sebagai is_suggestable
agar API saran dapat otomatis melengkapi nama dan nilai properti yang sesuai.
Mengintegrasikan dengan Autocomplete API
Jika Anda menggunakan aplikasi penelusuran default atau widget penelusuran yang dapat disematkan, fitur pelengkapan otomatis Cloud Search telah didukung secara native tanpa perlu pekerjaan tambahan. Ingat, secara default, frasa dari judul dokumen ditampilkan dalam pelengkapan otomatis. Properti skema harus ditandai secara eksplisit sebagai is_suggestable
agar API saran dapat melengkapi nama dan nilai properti yang sesuai secara otomatis.
Jika Anda mem-build aplikasi penelusuran kustom, pelengkapan otomatis tersedia dengan membuat kueri ke endpoint /query/suggest
API.
Batasan
Pelengkapan otomatis memiliki batasan berikut:
Membatasi frasa pelengkapan otomatis Cloud Search menggunakan
FilterOptions
yang ditentukan dalam skema tidak didukung, kecuali untuk filter bawaan berikut:objectype
,mimetype
, dan filter jenis.Saran berbasis histori kueri (penelusuran yang dilakukan oleh pengguna sebelumnya dalam aplikasi penelusuran) tidak didukung
Maksimum 20 properti dapat ditandai sebagai
is_suggestable
. Batas ini dapat ditingkatkan dengan menghubungi dukungan Cloud Search.Pelengkapan otomatis operator penelusuran tidak tersedia untuk properti dengan
exact_match_with_operator
.Pelengkapan otomatis Cloud Search menampilkan maksimum 5 saran dari konten dokumen dan 2 saran orang.
Pelengkapan otomatis Cloud Search hanya menyarankan frasa dari dokumen yang dapat diakses pengguna.