تکمیل خودکار جستجوی ابری گوگل با پیشنهاد کلمات هنگام تایپ عبارت جستجو به کاربران کمک میکند. به عنوان مثال، پیشنهادات ممکن است شامل کلماتی از عناوین اسناد، اپراتورهای جستجو یا نامهایی از سازمان Google Workspace شما باشد.
تکمیل خودکار، عبارات را از عناوین اسناد فهرستبندی شده استخراج میکند و از یک مدل n-gram برای تعیین پیشنهادات با استفاده از Suggest API استفاده میکند. به طور پیشفرض، تکمیل خودکار عبارات را از عناوین اسناد نشان میدهد. همچنین میتوانید ویژگیهای طرحواره متن و شمارشی را به عنوان is_suggestable علامتگذاری کنید تا نامها و مقادیر ویژگی تکمیل خودکار شوند.
API پیشنهاد، درخواستهای جستجو را برای یافتن نکات زبانی، مانند انگلیسی یا اسپانیایی، بررسی کرده و نتایج را اولویتبندی میکند. فیلد languageCode در یک درخواست نیز پیشنهادهای مختص به زبان را بهبود میبخشد.
سناریوی مثال
یک منبع داده حاوی دادههای فیلم را در نظر بگیرید:
- منبع داده شامل دو سند است.
- هر سند دارای یک عنوان (
ItemMetadata.title) و دو ویژگی است:genreوcharacters. - عنوان سند ۱: «انتقامجویان: جنگ ابدیت»؛
genre=science fiction؛characters=Iron Man, Hulk. - عنوان سند ۲: «هری پاتر»؛
genre=Adventure, Fantasy؛characters=Hermione, Harry Potter.
شکل ۱ نشان میدهد که چگونه تکمیل خودکار، پیشنهادها را استخراج میکند.
این مدل از سند ۱، n-gramها (تا سهگانهها) مانند «انتقامجویان»، «بینهایت»، «جنگ»، «انتقامجویان بینهایت»، «جنگ بینهایت» و «انتقامجویان جنگ بینهایت» را استخراج میکند. از سند ۲، «هری»، «پاتر» و «هری پاتر» را تولید میکند.
اگر کاربری هنگام جستجوی این منبع داده، "h" را تایپ کند، ممکن است این پیشنهادات را ببیند:
- هری
- هرمیون
- هالک
- هری پاتر
اگر کاربر «هرمیون» را انتخاب کند و سپس «a» را تایپ کند، تکمیل خودکار ممکن است موارد زیر را نشان دهد:
- ماجراجویی هرمیون
- اکشن هرمیون
- انتقامجویان هرمیون
تکمیل خودکار تلاش میکند آخرین کلمه یا n-gram تایپ شده را کامل کند. در این مثال، "a" را به "adventure"، "action" و "avengers" گسترش میدهد زیرا هیچ متن فهرستبندی شدهای با "hermione a" شروع نمیشود. این یک پیشنهاد دم دستی است.
تکمیل خودکار جستجوی ابری حداکثر پنج پیشنهاد از محتوای سند و دو پیشنهاد از افراد را برمیگرداند.
به طور پیشفرض، تکمیل خودکار عباراتی را از عناوین سند نشان میدهد. شما باید ویژگیهای طرحواره را به طور صریح به عنوان is_suggestable علامتگذاری کنید تا API Suggest بتواند نامها و مقادیر ویژگیها را به صورت خودکار تکمیل کند.
ادغام با API پیشنهادی
اگر از برنامه جستجوی پیشفرض یا ویجت جستجوی جاسازیشده استفاده میکنید، Cloud Search بهطور پیشفرض از تکمیل خودکار پشتیبانی میکند. اگر میخواهید ویژگیهای طرحواره بهطور خودکار تکمیل شوند، فراموش نکنید که آنها را با عنوان is_suggestable علامتگذاری کنید.
اگر در حال ساخت یک برنامه جستجوی سفارشی هستید، تکمیل خودکار با استفاده از نقاط پایانی API /query/suggest در دسترس است.
محدودیتها
تکمیل خودکار این محدودیتها را دارد:
- محدود کردن عبارات تکمیل خودکار با استفاده از
FilterOptionsپشتیبانی نمیشود، به جز برای فیلترهای داخلی مانندobjecttypeوmimetype. - پیشنهادهایی که بر اساس تاریخچهی جستجوی کاربر ارائه میشوند، پشتیبانی نمیشوند.
- شما میتوانید حداکثر ۲۰ ملک را به عنوان
is_suggestableعلامتگذاری کنید. برای افزایش این محدودیت با پشتیبانی Cloud Search تماس بگیرید. - تکمیل خودکار عملگر جستجو برای ویژگیهایی که دارای
exact_match_with_operatorهستند، در دسترس نیست. - قابلیت تکمیل خودکار حداکثر پنج پیشنهاد برای محتوای سند و دو پیشنهاد برای افراد ارائه میدهد.
- تکمیل خودکار فقط عباراتی را از اسنادی که کاربر میتواند به آنها دسترسی داشته باشد، پیشنهاد میدهد.