گوگل مستندات عمومی توسعهدهنده سرویس Web Search Service API را بهروزرسانی کرد؛ سرویسی که به شرکا اجازه میدهد نتایج جستجوی گوگل را در وبسایتها و اپهای خود بازیابی و نمایش دهند. گوگل در ۹ سپتامبر صفحه نمای کلی اصلی و چهار صفحه مرتبط را بهروزرسانی کرد و هر درخواست علاوه بر پروژه Google Cloud و کلید API، به یک شناسه مشتری (Client ID) متصل به توافقنامه شراکت نیاز دارد. پسزمینه این کار API جستجوی سفارشی JSON (Custom Search JSON API) است که در ژانویه ۲۰۲۷ پایان مییابد. گوگل در ژانویه به هرکسی که به نتایج سراسری وب نیاز داشت گفته بود برای راهحل جداگانه جستجوی کامل وب تماس بگیرد.
این API چه چیزی فراهم میکند؟
گوگل یک روش اصلی به نام Search مستند کرده که صفحه مرجع آن را «جستجوی وب کامل» توصیف میکند. نتایج بهصورت JSON از طریق REST یا gRPC بازگردانده میشود. هر درخواست باید شامل شناسه مشتری شریک، آدرس IP کاربر و عبارت جستجو باشد. طبق راهنمای فراخوانی، شاملکردن آدرس IP به مسیریابی منطقهای کمک میکند و از سوءاستفاده هم جلوگیری میکند. در هر درخواست تا ۲۰ نتیجه میتوان دریافت کرد (بهطور پیشفرض ۱۰) و امکان دریافت صفحات بیشتر با توکن وجود دارد. کاربران میتوانند نتایج را بر اساس زبان، کشور، بازه زمانی فیلتر کنند، SafeSearch را فعال کنند یا بر اساس تاریخ مرتب کنند. پاسخ فیلدهایی مثل عنوان، URL، اسنیپت، نوع MIME، قالب فایل، تخمین تعداد کل نتایج و عبارت تصحیحشده در صورت پیشنهاد گوگل فراهم میکند.
دسترسی محدود است
صفحات از کاربران با عنوان «شرکای برنامهنویسیشده» (programmatic partners) یاد میکنند. در صفحه معرفی توضیح داده شده که درخواستها از طریق شناسه مشتری به توافقنامه شراکت متصلاند. این شناسه از قالب استانداردی پیروی میکند که جزئیاتی مثل شریک، نام، محصول و مجموعه ویژگیها را شامل میشود.
این سرویس را از APIهایی که توسعهدهنده میتواند در پروژه Google Cloud فعال کند و بلافاصله استفاده کند متمایز میکند. با این حال، صفحات جزئیاتی درباره نحوه شریکشدن یک شرکت، هزینه سرویس یا محدودیتهای احتمالی کوئری ارائه نمیدهند.
جایگاه این API در گذار جستجو
گوگل در ژانویه اعلام کرد Programmable Search Element (ویجت جستجوی سایتش) حالا روی جستجو در ۵۰ دامنه یا کمتر متمرکز خواهد شد و نیازهای سازمانی مثل جستجوی گفتگویی و زمینسازی (grounding) را به Vertex AI Search ارجاع داد. برای شرکایی که میخواهند فراتر از مجموعهای از سایتها نگاه کنند، گوگل گفت راهحل جستجوی کامل وب برای «کسانی که به کل ایندکس ما نیاز دارند» دارد؛ شرکای علاقهمند میتوانند با پر کردن فرم ثبتنام کنند. گوگل هنوز ویژگیها یا قیمتگذاری دقیق ارائه نکرده. کاربران Search Element که روی بیش از ۵۰ دامنه یا کل وب جستجو میکنند باید تا ۱ ژانویه ۲۰۲۷ به راهحل دیگری کوچ کنند. همان مهلت برای کاربران Custom Search JSON API هم برقرار است و صفحه نمای کلی API گوگل حالا میگوید این API روی مشتریان جدید بسته است و در آن تاریخ متوقف میشود.
Web Search Service API از دو نظر با مورد استفاده جستجوی کامل وب از ژانویه همخوانی دارد: جستجوی کامل وب انجام میدهد و به شرکا محدود است. تا ۱۱ سپتامبر، نه پست ژانویه و نه صفحات بهروزرسانیشده به یکدیگر اشاره نمیکنند.
چرا این اهمیت دارد؟
اعلامیه ژانویه گوگل فرم علاقهمندی برای توسعهدهندگانی که به نتایج کامل وب نیاز دارند ارائه داد اما جزئیات زیادی درباره آن ارائه نداده بود. مستندات بهروزشده Web Search Service حالا توضیح بسیار روشنتری از نحوه کار API اختصاصی گوگل و الزامات پذیرش یک درخواست ارائه میدهد. افرادی که از Custom Search JSON API برای پروژههای جستجوی کامل وب استفاده میکنند همچنان مسیر مهاجرت کاملی ندارند. گوگل یک API کامل وب برای شرکا مستند کرده اما نگفته آیا کاربران فعلی میتوانند مهاجرت کنند یا شرکا چه الزاماتی باید داشته باشند.
چشمانداز پیش رو
مهلت ۱ ژانویه ۲۰۲۷ گوگل همچنان برقرار است. در عین حال باید منتظر بهروزرسانیهای مربوط به صلاحیت شرکا، هزینهها، محدودیتهای کوئری و اینکه آیا گوگل Web Search Service API را مسیر کاربران جستجوی کامل Custom Search معرفی میکند یا نه، بود. پست ژانویه گوگل همچنان کاربران Custom Search که به نتایج کامل وب نیاز دارند را به فرم علاقهمندیاش ارجاع میدهد و مستندات Web Search Service توضیح نمیدهد شرکتی چگونه توافقنامه شراکت لازم را به دست میآورد.