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

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

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

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

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

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

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

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

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

पहले दस्तावेज़ से, हम “Avengers”, “Infinity”, “War”, “Avengers Infinity”, “Infinity War”, “Avengers Infinity War” जैसे ट्रिग्रम तक के एनग्राम निकालते हैं. इसी तरह, दूसरे दस्तावेज़ से हम “Harry”, “Potter”, “Harry Potter” जनरेट करते हैं.

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

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

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

• Hermione Adventure
• Hermione Action
• Hermione Avengers

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

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

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

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

ध्यान दें: is_suggestable सिर्फ़ टेक्स्ट और एनम प्रॉपर्टी के लिए काम करती है.

अपने-आप पूरा होने वाले एपीआई के साथ इंटिग्रेट करना

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

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

ध्यान दें: दस्तावेज़ों को इंडेक्स करने के बाद, ऑटोमैटिक भरने की सुविधा के नतीजे दिखने में कम से कम 48 घंटे लगते हैं. इसके अलावा, फिर से इंडेक्स करने की वजह से, उस प्रॉपर्टी के लिए ऑटोमैटिक भरने की सुविधा का इस्तेमाल करने में देरी होती है.

सीमाएं

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

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

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

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

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

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

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