تساعد ميزة الإكمال التلقائي في Cloud Search المستخدم من خلال اقتراح كلمات عندما يكتب المستخدم طلب بحث. على سبيل المثال، قد تكون الاقتراحات عبارة عن كلمات من عناوين المستندات أو عوامل تشغيل البحث أو قيم عوامل تشغيل البحث أو الأسماء وعناوين البريد الإلكتروني من مؤسسة Google Workspace.
تُستخرج ميزة "الإكمال التلقائي" عبارات من عناوين المستندات المفهرَسة، وباستخدام نموذج الوحدات المتعددة، تحدّد الاقتراحات التي سيتم عرضها باستخدام Suggest API. تظهر العبارات من
عناوين المستندات تلقائيًا في ميزة الإكمال التلقائي. يمكنك أيضًا وضع علامة is_suggestable
على سمات schema.org الخاصة بالنص والعناصر المحدَّدة مسبقًا لإكمال اسم السمة
وقيمتها تلقائيًا.
تفحص Suggest API طلب البحث بحثًا عن نصائح حول لغة طلب البحث،
مثل الإنجليزية أو الإسبانية، وتمنح الأولوية للنتائج وفقًا لذلك. يُستخدَم حقل
languageCode
للطلب أيضًا لتحسين الاقتراحات المتعلّقة باللغة.
مثال على السيناريو
على سبيل المثال، لنفترض أنّ لديك مصدر البيانات التالي الذي يحتوي على بيانات عن الأفلام:
- يحتوي مصدر البيانات على مستندَين.
- يحتوي كل مستند على عنوان (
ItemMetadata.title
) وسمتَين:genre
وcharacters
. - عنوان المستند الأول هو "Avengers Infinity War" مع
genre=science fiction
وcharacters=Iron Man, Hulk
- عنوان المستند الثاني هو "هاري بوتر" مع
genre=Adventure, Fantasy and
characters=Hermione, Harry Potter`
يوضّح الشكل 1 كيفية استخراج اقتراحات الإكمال التلقائي من عنوان المستندات ومواقعها الجغرافية وقيم المواقع الجغرافية.
من المستند 1، نُخرج نصوصًا تتكوّن من n كلمة (ما يصل إلى ثلاث كلمات) مثل "Avengers" و"Infinity" و"War"، "Avengers Infinity" و"Infinity War" و"Avengers Infinity War". وبالمثل، من المستند 2، نُخرج "Harry" و"Potter" و"Harry Potter".
عند طلب البيانات من مصدر البيانات هذا، لنفترض أنّ المستخدم يبدأ بكتابة "h." يلي عناوين الاقتراحات التي ستظهر للمستخدم:
- CANNOT TRANSLATE
- هبة
- هالك
- هاري بوتر
لنفترض أنّ المستخدم اختار اقتراح الملء التلقائي "Hermione" وكانت ناتج ضغطة المفاتيح التالية من المستخدم هو الحرف "a". اقتراحات الإكمال التلقائي التي يتم عرضها للمستخدم هي:
- مغامرة هيرميون
- Hermione Action
- Hermione Avengers
تحاول ميزة "الإكمال التلقائي" إكمال الكلمة الأخيرة (أو السلسلة النصية) التي يتم كتابتها. في المثال السابق، يتم توسيع "أ" إلى "مغامرة" و"حركة" و "أبطال خارقين" فقط لأنّه لا يتوفّر نص يبدأ بـ "هيرميون أ" معًا. يُعرف هذا الاقتراح باسم "اقتراح الكلمات الأخيرة"، وهو يكمل تلقائيًا الكلمة الأخيرة/الوحدة التحليلية التي يتم كتابتها فقط.
تعرِض ميزة الإكمال التلقائي في Cloud Search 5 اقتراحات كحد أقصى من محتوى المستند واقتراحَين للأشخاص.
تظهر العبارات من عناوين المستندات تلقائيًا في ميزة الإكمال التلقائي. يجب وضع علامة is_suggestable
بشكل صريح على سمات Schema
لكي تتمكّن واجهة برمجة التطبيقات suggest API من
إكمال اسم السمة والقيم ذات الصلة تلقائيًا.
الدمج مع Autocomplete API
إذا كنت تستخدم تطبيق البحث التلقائي أو widget قابلاً للتضمين، تكون ميزة الإكمال التلقائي في Cloud Search متاحة تلقائيًا بدون أي عمل إضافي. تذكَّر أنّه يتم تلقائيًا عرض عبارات من عناوين
المستند في ميزة الإكمال التلقائي. يجب وضع علامة على سمات المخطط صراحةً على أنّها
is_suggestable
لكي تتمكّن Suggest API من إكمال اسم السمة
وقيمتها تلقائيًا.
إذا كنت بصدد إنشاء تطبيق بحث مخصّص، تتوفر ميزة "الإكمال التلقائي"
من خلال طلب نقاط نهاية واجهة برمجة التطبيقات /query/suggest
.
القيود
تنطبق القيود التالية على ميزة "الإكمال التلقائي":
لا يمكن فرض قيود على عبارات الإكمال التلقائي في "بحث Google في السحابة الإلكترونية" باستخدام
FilterOptions
المحدّد في المخطّط، باستثناء ملفّات الترشيح المضمّنة التالية:objectype
وmimetype
وفلاتر الأنواع.لا تتوفّر الاقتراحات المستندة إلى سجلّ طلبات البحث (عمليات البحث التي أجراها المستخدم سابقًا في أحد تطبيقات البحث).
يمكن وضع علامة
is_suggestable
على 20 موقعًا بحدّ أقصى. يمكن زيادة هذا الحدّ من خلال التواصل مع فريق دعم Cloud Search.لا تتوفّر ميزة الإكمال التلقائي لعوامل تشغيل البحث للمواقع التي تحتوي على
exact_match_with_operator
.تعرِض ميزة الإكمال التلقائي في Cloud Search 5 اقتراحات كحد أقصى من محتوى المستند واقتراحَين للأشخاص.
تقترح ميزة الإكمال التلقائي في "بحث Google" عبارات من ال مستندات التي يمكن للمستخدم الوصول إليها فقط.