अपने-आप पूरा होने की सुविधा लागू करना

जब उपयोगकर्ता कोई खोज क्वेरी टाइप कर रहा होता है, तब Cloud Search का ऑटोकंप्लीट सुविधा, शब्दों का सुझाव देकर उपयोगकर्ता की मदद करती है. उदाहरण के लिए, सुझावों में दस्तावेज़ के टाइटल, खोज ऑपरेटर, खोज ऑपरेटर की वैल्यू या Google Workspace संगठन से मिले नाम और ईमेल पते से लिए गए शब्द शामिल हो सकते हैं.

ऑटोकंप्लीट, इंडेक्स किए गए दस्तावेज़ों के टाइटल से फ़्रेज़ निकालता है और n-gram मॉडल का इस्तेमाल करके, Suggest API के ज़रिए दिखाए जाने वाले सुझाव तय करता है. डिफ़ॉल्ट रूप से, दस्तावेज़ के टाइटल के वाक्यांश ऑटोकंप्लीट में दिखते हैं. आपके पास टेक्स्ट और enum स्कीमा प्रॉपर्टी को is_suggestable के तौर पर मार्क करने का विकल्प भी होता है, ताकि प्रॉपर्टी के नाम और वैल्यू को अपने-आप पूरा किया जा सके.

Suggest API, क्वेरी की भाषा, जैसे कि अंग्रेज़ी या स्पैनिश के बारे में संकेतों के लिए खोज क्वेरी की जांच करता है और उसके हिसाब से नतीजों को प्राथमिकता देता है. अनुरोध के languageCode फ़ील्ड का इस्तेमाल, खास भाषा के सुझावों को बेहतर बनाने के लिए भी किया जाता है.

उदाहरण के तौर पर

उदाहरण के लिए, मान लें कि आपके पास फ़िल्मों के बारे में डेटा वाला डेटा सोर्स है:

  • डेटा सोर्स में दो दस्तावेज़ होते हैं.
  • हर दस्तावेज़ में एक टाइटल (ItemMetadata.title) और दो प्रॉपर्टी होती हैं: genre और characters.
  • पहले दस्तावेज़ का टाइटल "एवेंजर्स इंफ़िनिटी वॉर" है. इसमें genre=science fiction और characters=Iron Man, Hulk शामिल हैं
  • दूसरे दस्तावेज़ का टाइटल "हैरी पॉटर" है. इसमें genre=Adventure, Fantasy andवर्ण=हर्माइनी, हैरी पॉटर` है

इमेज 1 में दिखाया गया है कि दस्तावेज़ों के टाइटल, प्रॉपर्टी, और प्रॉपर्टी की वैल्यू से अपने-आप पूरा होने वाले सुझावों को कैसे निकाला जाता है.

दो दस्तावेज़ और उनके बाद मिलने वाला ngram
पहली इमेज. ऑटोकंप्लीट के लिए दो दस्तावेज़ और उनसे मिला एन-ग्राम

दस्तावेज़ 1 से, हमने एनग्राम (त्रिग्राम तक) “एवेंजर्स”, “इनफ़िनिटी”, “वॉर”, “एवेंजर्स इंफ़िनिटी”, “इनफ़िनिटी वॉर”, “एवेंजर्स इंफ़िनिटी वॉर”, निकाली है. इसी तरह, हमने दूसरे दस्तावेज़ से “हैरी”, “पॉटर”, और “हैरी पॉटर” जनरेट की है.

इस डेटा सोर्स की क्वेरी करते समय, मान लें कि उपयोगकर्ता "h" टाइप करके शुरुआत करता है. उपयोगकर्ता को ये सुझाव दिखाए जाएंगे:

  • पन
  • हर्माइन
  • हल्क
  • हैरी पॉटर

मान लें कि उपयोगकर्ता अपने-आप पूरा होने वाले सुझाव “Hermione” को चुनता है और उपयोगकर्ता का अगला कीस्ट्रोक "a" वर्ण होता है. लोगों को अपने-आप पूरे होने वाले सुझाव ये होंगे:

  • हर्माइनी ऐडवेंचर
  • हर्माइनी ऐक्शन
  • हर्माइन एवेंजर्स

ऑटोकंप्लीट, लिखे जा रहे आखिरी शब्द (या ngram) को पूरा करने की कोशिश करता है. पिछले उदाहरण में, यह "a" को "रोमांचक", "कार्रवाई", और "एवेंजर्स" में बड़ा करता है, क्योंकि "हर्मियन a" से शुरू होने वाला कोई भी टेक्स्ट नहीं है. इस सुझाव को टेल सुझाव कहते हैं. टाइप किए जाने वाले सिर्फ़ आखिरी शब्द/एन-ग्राम को अपने-आप पूरा करना.

Cloud Search अपने-आप पूरा होने की सुविधा के साथ, दस्तावेज़ के कॉन्टेंट से ज़्यादा से ज़्यादा पांच सुझाव और दो लोगों के सुझाव दिखाता है.

डिफ़ॉल्ट रूप से, दस्तावेज़ के टाइटल में मौजूद वाक्यांश, ऑटोकंप्लीट सुविधा में दिखते हैं. सुझाए गए एपीआई के लिए, स्कीमा प्रॉपर्टी को खास तौर पर is_suggestable के तौर पर मार्क करना ज़रूरी है, ताकि आप उनसे जुड़ी प्रॉपर्टी के नाम और वैल्यू को अपने-आप पूरा कर सकें.

ऑटोकंप्लीट एपीआई के साथ इंटिग्रेट करें

अगर डिफ़ॉल्ट सर्च ऐप्लिकेशन या एम्बेड किए जा सकने वाले सर्च विजेट का इस्तेमाल किया जा रहा है, तो Cloud Search की ऑटोकंप्लीट सुविधा, मूल रूप से इस पर काम करती है. इसके लिए आपको अलग से कोई काम नहीं करना पड़ता. याद रखें कि डिफ़ॉल्ट रूप से, दस्तावेज़ के टाइटल के वाक्यांश ऑटोकंप्लीट में दिखते हैं. सुझाए गए एपीआई के लिए, स्कीमा प्रॉपर्टी को खास तौर पर is_suggestable के तौर पर मार्क करना ज़रूरी है, ताकि आप उनसे जुड़ी प्रॉपर्टी के नाम और वैल्यू को अपने-आप पूरा कर सकें.

अगर पसंद के मुताबिक सर्च ऐप्लिकेशन बनाया जा रहा है, तो /query/suggest API एंडपॉइंट से क्वेरी करके ऑटोकंप्लीट की सुविधा उपलब्ध होती है.

सीमाएं

ऑटोकंप्लीट की सुविधा की ये सीमाएं हैं:

  • स्कीमा में बताए गए FilterOptions फ़िल्टर का इस्तेमाल करके, Cloud Search के अपने-आप पूरे होने वाले वाक्यांशों को सीमित करने की सुविधा काम नहीं करती. हालांकि, इन पहले से मौजूद फ़िल्टर को छोड़कर, objectype, mimetype, और टाइप फ़िल्टर को सीमित नहीं किया जा सकता.

  • क्वेरी इतिहास के आधार पर सुझाव (उपयोगकर्ता ने पहले किसी खोज ऐप्लिकेशन में की गई खोजें) का इस्तेमाल नहीं किया है

  • ज़्यादा से ज़्यादा 20 प्रॉपर्टी को is_suggestable के तौर पर मार्क किया जा सकता है. इस सीमा को बढ़ाने के लिए, Cloud Search की सहायता टीम से संपर्क करें.

  • exact_match_with_operator वाली प्रॉपर्टी के लिए, खोज ऑपरेटर ऑटोकंप्लीट की सुविधा उपलब्ध नहीं है.

  • Cloud Search अपने-आप पूरा होने की सुविधा के साथ, दस्तावेज़ के कॉन्टेंट से ज़्यादा से ज़्यादा पांच सुझाव और दो लोगों के सुझाव दिखाता है.

  • Cloud Search ऑटोकंप्लीट की सुविधा, सिर्फ़ उन दस्तावेज़ों के वाक्यांशों के सुझाव देती है जिनका ऐक्सेस उपयोगकर्ता के पास होता है.