Cloud Search'ün otomatik tamamlama özelliği, kullanıcı bir arama sorgusu yazarken kelime önererek kullanıcıya yardımcı olur. Örneğin, öneriler doküman başlıkları, arama operatörleri, arama operatörü değerleri veya Google Workspace kuruluşundaki adlar ve e-posta adreslerindeki kelimeler olabilir.
Otomatik tamamlama, dizine eklenen belgelerin başlıklarından kelime öbekleri çıkarır ve n-gram modeli kullanarak, Suggest API'si ile sunulacak önerileri belirler. Varsayılan olarak, doküman başlıklarındaki
ifadeler otomatik tamamlamada gösterilir. İlgili özellik adını ve değerlerini otomatik olarak tamamlamak için metin ve enum şeması özelliklerini is_suggestable
olarak da işaretleyebilirsiniz.
Suggest API'si, arama sorgusunu sorgunun diliyle ilgili ipuçları için (ör. İngilizce veya İspanyolca) inceler ve sonuçları buna göre önceliklendirir. İsteğin languageCode
alanı, dile özgü önerileri iyileştirmek için de kullanılır.
Örnek senaryo
Örneğin, filmlerle ilgili verileri içeren aşağıdaki veri kaynağınız olduğunu varsayalım:
- Veri kaynağı 2 doküman içeriyor.
- Her dokümanın bir başlığı (
ItemMetadata.title
) ve iki özelliği vardır:genre
vecharacters
. - İlk belgenin başlığı,
genre=science fiction
vecharacters=Iron Man, Hulk
öğelerinin yer aldığı "Avengers Infinity War" (Yenilmezler: Sonsuzluk Savaşı) - İkinci dokümanın başlığı "Harry Potter" ve
genre=Adventure, Fantasy and
characters=Hermione, Harry Potter`
Şekil 1'de otomatik tamamlama önerilerinin doküman başlıklarından, özelliklerinden ve özellik değerlerinden nasıl çıkarıldığı gösterilmektedir.
1. belgeden ngram (trigramlara kadar) "Yenilmezler", "Sonsuzluk", "Savaş", "Yenilmezler Sonsuzluk", "Sonsuzluk Savaşı", "Yenilmezler Sonsuzluk Savaşı", "Avengers Sonsuzluk Savaşı", "Harry", "Potter", "Harry Potter"ı oluşturuyoruz.
Bu veri kaynağını sorgularken kullanıcının "h" yazarak başladığını varsayalım. Kullanıcıya gösterilen öneriler şunlardır:
- Ders
- Hermione
- Hulk
- Harry Potter
Kullanıcının "Hermione" otomatik tamamlama önerisini seçtiğini ve kullanıcının bir sonraki tuş vuruşunun "a" karakteri olduğunu varsayalım. Kullanıcıya gösterilen otomatik tamamlama önerileri şöyle olur:
- Hermione Macerası
- Hermione Aksiyon
- Hermione Yenilmezler
Otomatik tamamlama, yazılan son kelimeyi (veya ngram) tamamlamaya çalışır. Önceki örnekte, "hermione a" ile başlayan bir metin olmadığından "a" harfi yalnızca "macera", "action" ve "avengers" şeklinde genişletilmektedir. Bu öneriye kuyruk önerisi adı verilir ve yalnızca yazılan son kelimeyi/n-gramı otomatik olarak tamamlar.
Cloud Search'ün otomatik tamamlama özelliği, doküman içeriğinden en fazla 5 öneri ve 2 kişi önerisi döndürür.
Varsayılan olarak, doküman başlıklarındaki ifadeler otomatik tamamlamada gösterilir. Şema özellikleri, Öneri API'sinin karşılık gelen özellik adını ve değerlerini otomatik olarak tamamlaması için açık bir şekilde is_suggestable
olarak işaretlenmelidir.
Autocomplete API ile entegrasyon
Varsayılan arama uygulamasını veya yerleştirilebilir arama widget'ını kullanıyorsanız Cloud Search'ün otomatik tamamlama özelliği, herhangi bir ek iş gerekmeden yerel olarak desteklenir. Varsayılan olarak, doküman başlıklarındaki ifadelerin otomatik tamamlamada gösterildiğini unutmayın. Öneri API'sinin ilgili özellik adını ve değerlerini otomatik olarak tamamlaması için şema özelliklerinin açıkça is_suggestable
olarak işaretlenmesi gerekir.
Özel bir arama uygulaması oluşturuyorsanız /query/suggest
API uç noktalarını sorgulayarak otomatik tamamlama özelliğini kullanabilirsiniz.
Sınırlamalar
Otomatik tamamlamada aşağıdaki sınırlamalar geçerlidir:
Şemada tanımlanan
FilterOptions
öğesini kullanarak Cloud Search'ün otomatik tamamlama ifadelerini kısıtlama, şu yerleşik filtreler dışında desteklenmemektedir:objectype
,mimetype
ve tür filtreleri.Sorgu geçmişine dayalı öneriler (kullanıcı tarafından daha önce bir arama uygulamasında yapılan aramalar) desteklenmez
En fazla 20 mülk
is_suggestable
olarak işaretlenebilir. Bu sınır, Cloud Search destek ekibiyle iletişime geçilerek artırılabilir.Arama operatörü otomatik tamamlama özelliği
exact_match_with_operator
içeren mülklerde kullanılamaz.Cloud Search'ün otomatik tamamlama özelliği, doküman içeriğinden en fazla 5 öneri ve 2 kişi önerisi döndürür.
Cloud Search'ün otomatik tamamlama özelliği, yalnızca kullanıcının erişebildiği dokümanlardaki ifadeleri önerir.