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

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

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

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

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

फ़िल्मों का डेटा दिखाने वाले डेटा सोर्स पर विचार करें:

  • डेटा सोर्स में दो दस्तावेज़ शामिल हैं.
  • हर दस्तावेज़ का एक टाइटल (ItemMetadata.title) होता है. साथ ही, इसमें दो प्रॉपर्टी होती हैं: genre और characters.
  • पहले दस्तावेज़ का टाइटल: "Avengers Infinity War"; genre=science fiction; characters=Iron Man, Hulk.
  • दूसरे दस्तावेज़ का टाइटल: "हैरी पॉटर"; genre=Adventure, Fantasy; characters=Hermione, Harry Potter.

पहली इमेज में दिखाया गया है कि ऑटोकंप्लीट की सुविधा, सुझावों को कैसे निकालती है.

दो दस्तावेज़ और उनसे मिला n-ग्राम
पहली इमेज. अपने-आप पूरा होने की सुविधा के लिए इस्तेमाल किए गए दो दस्तावेज़ और उनसे मिला एन-ग्राम

दस्तावेज़ 1 से, मॉडल n-ग्राम (ट्रायग्राम तक) निकालता है. जैसे, "Avengers," "Infinity," "War," "Avengers Infinity," "Infinity War," और "Avengers Infinity War." दूसरे दस्तावेज़ से, "हैरी," "पॉटर," और "हैरी पॉटर" जनरेट करता है.

अगर कोई उपयोगकर्ता इस डेटा सोर्स से क्वेरी करते समय "h" टाइप करता है, तो उसे ये सुझाव दिख सकते हैं:

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

अगर उपयोगकर्ता "हर्मायनी" चुनता है और फिर "a" टाइप करता है, तो अपने-आप पूरा होने की सुविधा से ये विकल्प दिख सकते हैं:

  • Hermione Adventure
  • Hermione Action
  • Hermione Avengers

ऑटोमैटिक भरने की सुविधा, टाइप किए गए आखिरी शब्द या n-ग्राम को पूरा करने की कोशिश करती है. इस उदाहरण में, "a" को "adventure," "action," और "avengers" में बड़ा किया गया है, क्योंकि इंडेक्स किया गया कोई भी टेक्स्ट "hermione a." से शुरू नहीं होता है. यह एक टेल सुझाव है.

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

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

Suggest API के साथ इंटिग्रेट करना

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

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

सीमाएं

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

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