این صفحه به نسخه XML از API جستجوی سفارشی JSON اشاره دارد که فقط برای مشتریان جستجوی سایت گوگل در دسترس است.
- نمای کلی
- قالب درخواست موتور جستجو قابل برنامهریزی
- نتایج XML
نمای کلی
سرویس جستجوی وب گوگل (Google WebSearch) به مشتریان جستجوی سایت گوگل (Google Site Search) این امکان را میدهد که نتایج جستجوی گوگل را در وبسایتهای خود نمایش دهند. سرویس جستجوی وب از یک پروتکل ساده مبتنی بر HTTP برای ارائه نتایج جستجو استفاده میکند. مدیران جستجو کنترل کاملی بر نحوه درخواست نتایج جستجو و نحوه ارائه آن نتایج به کاربر نهایی دارند. این سند جزئیات فنی درخواست جستجوی گوگل و قالبهای نتایج را شرح میدهد.
برای بازیابی نتایج جستجوی وب گوگل، برنامه شما یک درخواست HTTP ساده به گوگل ارسال میکند. سپس گوگل نتایج جستجو را در قالب XML برمیگرداند. نتایج با قالب XML به شما این امکان را میدهد که نحوه نمایش نتایج جستجو را سفارشی کنید.
قالب درخواست جستجوی وب
- بررسی اجمالی درخواست
- شرایط پرس و جو
- پارامترهای درخواست
- نمونه سوالات جستجوی وب
- تعاریف پارامترهای جستجوی وب
- نمونه سوالات تصویری
- تعاریف پارامترهای جستجوی تصویر
- جستجوی پیشرفته
- پارامترهای جستجوی پیشرفته
- شرایط پرس و جوی ویژه
- محدودیتهای درخواست
بررسی اجمالی درخواست
درخواست جستجوی گوگل یک دستور استاندارد HTTP GET است. این دستور شامل مجموعهای از پارامترهای مرتبط با درخواستهای شما است. این پارامترها در URL درخواست به صورت جفتهای name=value که با کاراکترهای ampersand (&) از هم جدا شدهاند، گنجانده شدهاند. پارامترها شامل دادههایی مانند عبارت جستجو و یک شناسه موتور منحصر به فرد ( cx ) هستند که موتوری را که درخواست HTTP را انجام میدهد، شناسایی میکند. سرویس WebSearch یا جستجوی تصویر، نتایج XML را در پاسخ به درخواستهای HTTP شما برمیگرداند.
شرایط پرس و جو
بیشتر درخواستهای جستجو شامل یک یا چند عبارت جستجو هستند. یک عبارت جستجو به عنوان مقدار یک پارامتر در درخواست جستجو ظاهر میشود.
عبارات جستجو میتوانند انواع مختلفی از اطلاعات را برای فیلتر کردن و سازماندهی نتایج جستجوی گوگل مشخص کنند. جستجوها میتوانند موارد زیر را مشخص کنند:
- کلمات یا عباراتی که باید گنجانده یا حذف شوند
- تمام کلمات موجود در یک عبارت جستجو (پیشفرض)
- یک عبارت دقیق در عبارت جستجو شده
- هر کلمه یا عبارتی در یک عبارت جستجو شده
- در کجای یک سند باید عبارتهای جستجو را جستجو کرد
- هر جایی در سند (پیشفرض)
- فقط در لینکهای موجود در سند
- محدودیتهای مربوط به خود اسناد
- گنجاندن یا حذف اسناد از انواع فایل خاص (مانند فایلهای PDF یا اسناد Word)
- کوئریهای ویژه URL که به جای انجام جستجو، اطلاعاتی در مورد یک URL مشخص برمیگردانند
- کوئریهایی که اطلاعات کلی در مورد یک URL، مانند دستهبندی دایرکتوری باز، قطعه کد یا زبان آن را برمیگردانند
- پرسوجوهایی که مجموعهای از صفحات وب را که به یک URL پیوند دارند، برمیگردانند
- پرسوجوهایی که مجموعهای از صفحات وب مشابه با یک URL مشخص را برمیگردانند
جستجوی پیشفرض
مقادیر پارامترهای جستجوی عبارت جستجو باید با URL-escaped جایگزین شوند. توجه داشته باشید که باید علامت جمع ("+") را به جای هر توالی فاصله در عبارت جستجو قرار دهید. این موضوع در بخش URL Escaping این سند بیشتر مورد بحث قرار گرفته است.
عبارت جستجوی مورد نظر با استفاده از پارامتر q به سرویس WebSearch ارسال میشود. یک نمونه عبارت جستجوی مورد نظر به صورت زیر است:
q=horses+cows+pigs
به طور پیشفرض، سرویس جستجوی وب گوگل فقط اسنادی را برمیگرداند که شامل تمام عبارات موجود در عبارت جستجو شده باشند.
پارامترهای درخواست
این بخش پارامترهایی را که میتوانید هنگام ایجاد درخواست جستجو استفاده کنید، فهرست میکند. پارامترها به دو لیست تقسیم میشوند. لیست اول شامل پارامترهایی است که به همه درخواستهای جستجو مربوط میشوند. لیست دوم شامل پارامترهایی است که فقط به درخواستهای جستجوی پیشرفته مربوط میشوند.
سه پارامتر درخواست مورد نیاز است:
- پارامتر کلاینت باید روی
google-csbeتنظیم شود. - پارامتر خروجی ، قالب نتایج XML برگردانده شده را مشخص میکند؛ نتایج میتوانند با (xml) یا بدون (
xml_no_dtd) ارجاع به DTD گوگل برگردانده شوند. توصیه میکنیم این مقدار را رویxml_no_dtdتنظیم کنید. توجه: اگر این پارامتر را مشخص نکنید، نتایج به جای XML به صورت HTML برگردانده میشوند. - پارامتر cx که نشان دهنده شناسه منحصر به فرد موتور است.
پارامترهای درخواست رایجتر به غیر از موارد ذکر شده در بالا عبارتند از:
نمونه سوالات جستجوی وب
مثالهای زیر چند درخواست HTTP از WebSearch را نشان میدهند تا نحوه استفاده از پارامترهای مختلف پرسوجو را نشان دهند. تعاریف پارامترهای مختلف پرسوجو در بخشهای « تعاریف پارامترهای پرسوجوی WebSearch» و « پارامترهای پرسوجوی جستجوی پیشرفته» این سند ارائه شده است.
این درخواست، 10 نتیجه اول ( start=0&num=10 ) را برای عبارت جستجوی "red sox" ( q=red+sox ) درخواست میکند. این جستجو همچنین مشخص میکند که نتایج باید از وبسایتهای کانادایی ( cr=countryCA ) گرفته شوند و باید به زبان فرانسوی ( lr=lang_fr ) نوشته شوند. در نهایت، جستجو مقادیر پارامترهای client ، output و cx را مشخص میکند که هر سه مورد ضروری هستند.
http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
این مثال از برخی از پارامترهای جستجوی پیشرفته برای سفارشیسازی بیشتر جستجوی جستجو استفاده میکند. این درخواست به جای پارامتر q از پارامتر as_q ( as_q=red+sox ) استفاده میکند. همچنین از پارامتر as_eq برای حذف هر سندی که حاوی کلمه "Yankees" باشد از نتایج جستجو ( as_eq=yankees ) استفاده میکند.
http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i
تعاریف پارامترهای جستجوی وب
| سی۲کاف | |||||||
|---|---|---|---|---|---|---|---|
| توضیحات | اختیاری . پارامتر c2coff ویژگی جستجوی چینی سادهشده و سنتی را فعال یا غیرفعال میکند. مقدار پیشفرض برای این پارامتر
| ||||||
| مثالها | q=google&c2coff=1 | ||||||
| مشتری | |
|---|---|
| توضیحات | الزامی . پارامتر |
| مثالها | q=google&client=google-csbe |
| کرا | |
|---|---|
| توضیحات | اختیاری . پارامتر جستجوی وب گوگل با تجزیه و تحلیل موارد زیر، کشور یک سند را تعیین میکند:
برای مشاهده فهرستی از مقادیر معتبر برای این پارامتر، به بخش مقادیر پارامتر کشور (cr) مراجعه کنید. |
| مثالها | q=Frodo&cr=countryNZ |
| سی ایکس | |
|---|---|
| توضیحات | الزامی . پارامتر |
| مثالها | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
| فیلتر | |||||||
|---|---|---|---|---|---|---|---|
| توضیحات | اختیاری . پارامتر فیلتر، فیلتر خودکار نتایج جستجوی گوگل را فعال یا غیرفعال میکند. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی گوگل، به بخش فیلتر خودکار این سند مراجعه کنید. مقدار پیشفرض برای پارامتر
توجه: گوگل به طور پیشفرض، فیلتر کردن را برای همه نتایج جستجو اعمال میکند تا کیفیت آن نتایج را بهبود بخشد. | ||||||
| مثالها | q=google&filter=0 | ||||||
| گل | |
|---|---|
| توضیحات | اختیاری . مقدار پارامتر تعیین مقدار پارامتر |
| مثالها | این درخواست، رتبه اسناد نوشته شده در بریتانیا را در نتایج جستجوی وب افزایش میدهد: |
| اچ ال | |
|---|---|
| توضیحات | اختیاری . پارامتر برای اطلاعات بیشتر به بخش زبانهای رابط در بینالمللیسازی پرسوجوها و ارائه نتایج و برای فهرستی از زبانهای پشتیبانیشده به بخش زبانهای رابط پشتیبانیشده مراجعه کنید. |
| مثالها | این درخواست، تبلیغات شراب به زبان فرانسوی را هدف قرار میدهد. ( Vin اصطلاح فرانسوی برای شراب است.) q=vin&ip=10.10.10.10&ad=w5& hl=fr |
| ستاد مرکزی | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | این درخواست به دنبال «پیتزا» و «پنیر» میگردد. عبارت آن مشابه |
| یعنی | |
|---|---|
| توضیحات | اختیاری . پارامتر برای بحث در مورد اینکه چه زمانی ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش کدگذاری کاراکتر مراجعه کنید. برای مشاهدهی فهرست مقادیر ممکن برای |
| مثالها | q=google&ie=utf8&oe=utf8 |
| ل | |
|---|---|
| توضیحات | اختیاری . پارامتر جستجوی وب گوگل با تجزیه و تحلیل موارد زیر، زبان یک سند را تعیین میکند:
برای مشاهدهی فهرستی از مقادیر معتبر برای این پارامتر، به بخش « مقادیر مجموعه زبان» ( |
| مثالها | q=Frodo&lr=lang_en |
| عدد | |
|---|---|
| توضیحات | اختیاری . پارامتر مقدار پیشفرض نکته: اگر تعداد کل نتایج جستجو کمتر از تعداد نتایج درخواستی باشد، تمام نتایج جستجوی موجود بازگردانده میشوند. |
| مثالها | q=google& num=10 |
| اوه | |
|---|---|
| توضیحات | اختیاری . پارامتر برای بحث در مورد اینکه چه زمانی ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش کدگذاری کاراکتر مراجعه کنید. برای مشاهدهی فهرست مقادیر ممکن |
| مثالها | q=google&ie=utf8& oe=utf8 |
| خروجی | |||||||
|---|---|---|---|---|---|---|---|
| توضیحات | الزامی . پارامتر
| ||||||
| مثالها | output=xml_no_dtd | ||||||
| س | |
|---|---|
| توضیحات | اختیاری . پارامتر همچنین تعدادی اصطلاح خاص برای پرسوجو وجود دارد که میتوانند به عنوان بخشی از مقدار پارامتر پنل کنترل جستجوی گوگل شامل گزارشی از پرسوجوهای برتر ارسال شده با استفاده از پارامتر نکته: مقداری که برای پارامتر q مشخص شده است باید URL-escaped باشد. |
| مثالها | q=vacation &as_oq=london+paris |
| امن | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| توضیحات | اختیاری . پارامتر
برای جزئیات بیشتر در مورد این ویژگی، به بخش فیلتر کردن محتوای بزرگسالان با جستجوی ایمن مراجعه کنید. | ||||||||
| مثالها | q=adult&safe=high | ||||||||
| شروع | |
|---|---|
| توضیحات | اختیاری . پارامتر پارامتر |
| مثالها | start=10 |
| مرتب سازی | |
|---|---|
| توضیحات | اختیاری است . پارامتر |
| مثالها | |
| یو دی | |
|---|---|
| توضیحات | اختیاری . پارامتر http://www.花井鮨.com مقادیر معتبر برای این پارامتر اگر پارامتر http://www.xn--elq438j.com توجه: این یک ویژگی بتا است. |
| مثالها | q=google&ud=1 |
جستجوی پیشرفته
پارامترهای جستجوی اضافی ذکر شده در زیر تصویر مربوط به جستجوهای پیشرفته هستند. وقتی جستجوی پیشرفتهای را ارسال میکنید، مقادیر چندین پارامتر (مثلاً as_eq ، as_epq ، as_oq و غیره) همگی در عبارات جستجوی آن جستجو لحاظ میشوند. تصویر صفحه جستجوی پیشرفته گوگل را نشان میدهد. در تصویر، نام هر پارامتر جستجوی پیشرفته با متن قرمز در داخل یا کنار فیلدی در صفحهای که آن پارامتر به آن مربوط میشود، نوشته شده است.
پارامترهای جستجوی پیشرفته
| as_dt | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | as_dt=i,as_dt=e |
| as_epq | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | as_epq=abraham+lincoln |
| as_eq | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | |
| as_lq | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | |
| as_nlo | |
|---|---|
| توضیحات | اختیاری است . پارامتر |
| مثالها | موارد زیر محدوده جستجو را از ۵ تا ۱۰ تعیین میکند: |
| as_nhi | |
|---|---|
| توضیحات | اختیاری است . پارامتر |
| مثالها | موارد زیر محدوده جستجو را از ۵ تا ۱۰ تعیین میکند: |
| as_oq | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | |
| as_q | |
|---|---|
| توضیحات | اختیاری است . پارامتر |
| مثالها | |
| as_qdr | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | این مثال نتایج سال گذشته را درخواست میکند: این مثال نتایج ۱۰ روز گذشته را درخواست میکند: |
| جستجوی سایت as_site | |
|---|---|
| توضیحات | اختیاری . پارامتر |
| مثالها | |
شرایط پرس و جوی ویژه
جستجوی وب گوگل (Google WebSearch) امکان استفاده از چندین عبارت جستجوی ویژه را فراهم میکند که به قابلیتهای اضافی موتور جستجوی گوگل دسترسی دارند. این عبارات جستجوی ویژه باید در مقدار پارامتر درخواست q گنجانده شوند. مانند سایر عبارات جستجوی ویژه، عبارات جستجوی ویژه باید URL-escaped داشته باشند. تعدادی از عبارات جستجوی ویژه حاوی علامت دونقطه (:) هستند. این کاراکتر نیز باید URL-escaped باشد. مقدار URL-escaped آن %3A است.
| لینکهای برگشتی [لینک:] | |
|---|---|
| توضیحات | نسخه URL-escaped از همچنین میتوانید از پارامتر درخواست as_lq برای ارسال درخواست توجه: هنگام استفاده از |
| مثالها | |
| جستجوی بولی یا [یا] | |
|---|---|
| توضیحات | عبارت جستجوی همچنین میتوانید از پارامتر درخواست as_oq برای ارسال جستجو برای هر اصطلاحی در مجموعهای از اصطلاحات استفاده کنید. توجه: اگر درخواست جستجو عبارت "لندن+یا+پاریس" را مشخص کند، نتایج جستجو شامل اسنادی خواهد بود که حداقل یکی از این دو کلمه را داشته باشند. در برخی موارد، اسناد موجود در نتایج جستجو ممکن است حاوی هر دو کلمه باشند. |
| مثالها | جستجوی لندن یا پاریس: ورودی کاربر: london OR paris عبارت جستجو: q=london+OR+parisجستجوی تعطیلات و لندن یا پاریس: عبارت جستجو: q=vacation+london+OR+parisجستجوی تعطیلات و یکی از شهرهای لندن، پاریس یا شکلات: عبارت جستجو: q=vacation+london+OR+paris+OR+chocolatesبرای تعطیلات و شکلاتها و همچنین لندن یا پاریس جستجو کنید، و کمترین وزن به شکلاتها داده شود: عبارت جستجو: q=vacation+london+OR+paris+chocolatesجستجوی تعطیلات، شکلات و گل در اسنادی که شامل لندن یا پاریس نیز میشوند: عبارت جستجو: q=vacation+london+OR+paris+chocolates+flowersبرای تعطیلات و یکی از شهرهای لندن یا پاریس جستجو کنید و همچنین یکی از شهرهای شکلات یا گل را نیز جستجو کنید: عبارت جستجو: q=vacation+london+OR+paris+chocolates+OR+flowers |
| عبارت جستجو را حذف کنید [-] | |
|---|---|
| توضیحات | عبارت جستجوی «حذف» ( نسخه URL-escaped از عبارت جستجوی «حذف» زمانی مفید است که یک عبارت جستجو بیش از یک معنی داشته باشد. برای مثال، کلمه «باس» میتواند نتایجی در مورد ماهی یا موسیقی ارائه دهد. اگر به دنبال اسنادی در مورد ماهی هستید، میتوانید با استفاده از عبارت جستجوی «حذف» اسناد مربوط به موسیقی را از نتایج جستجوی خود حذف کنید. همچنین میتوانید از پارامتر درخواست as_eq برای حذف اسناد منطبق با یک کلمه یا عبارت خاص از نتایج جستجو استفاده کنید. |
| مثالها | ورودی کاربر: bass -musicعبارت جستجو: q=bass+ %2Dmusic |
| استثنای نوع فایل [ -filetype: ] | |
|---|---|
| توضیحات | عبارت جستجوی نسخه URL-escaped از نکته: میتوانید با اضافه کردن عبارات جستجوی بیشتر با استفاده انواع فایلهای پشتیبانیشده توسط گوگل عبارتند از:
ممکن است در آینده انواع فایلهای بیشتری اضافه شود. فهرست بهروز شده را همیشه میتوانید در بخش سوالات متداول انواع فایل گوگل پیدا کنید. |
| مثالها | این مثال اسنادی را برمیگرداند که در آنها از «گوگل» نام برده شده است اما اسناد PDF نیستند: این مثال اسنادی را که در آنها از «گوگل» استفاده شده است، برمیگرداند اما اسناد PDF و Word را حذف میکند: |
| فیلتر کردن نوع فایل [ filetype: ] | |
|---|---|
| توضیحات | عبارت جستجوی نسخه URL-escaped از شما میتوانید با اضافه کردن عبارات جستجوی به طور پیشفرض، نتایج جستجو شامل اسنادی با هر پسوند فایلی خواهد بود. انواع فایلهای پشتیبانیشده توسط گوگل عبارتند از:
ممکن است در آینده انواع فایلهای بیشتری اضافه شود. فهرست بهروز شده را همیشه میتوانید در بخش سوالات متداول انواع فایل گوگل پیدا کنید. |
| مثالها | این مثال اسناد PDF را که در آنها از «Google» نام برده شده است، برمیگرداند: این مثال اسناد PDF و Word را که در آنها از "Google" نام برده شده است، برمیگرداند: |
| عبارت جستجو را وارد کنید [+] | |
|---|---|
| توضیحات | عبارت جستجوی include (+) مشخص میکند که یک کلمه یا عبارت باید در تمام اسناد موجود در نتایج جستجو وجود داشته باشد. برای استفاده از عبارت جستجوی include، باید کلمه یا عبارتی را که باید در تمام نتایج جستجو وجود داشته باشد، با "+" (علامت جمع) شروع کنید. نسخه URL-escaped از شما باید قبل از یک کلمه رایج که گوگل معمولاً قبل از شناسایی نتایج جستجو آن را نادیده میگیرد، |
| مثالها | ورودی کاربر: Star Wars Episode +Iعبارت جستجو: q=Star+Wars+Episode+ %2BI |
| جستجوی فقط لینکها، همه عبارات [ allinlinks: ] | |
|---|---|
| توضیحات | عبارت اگر عبارت جستجوی شما شامل عبارت نسخه URL-escaped از |
| مثالها | ورودی کاربر: allinlinks: Google searchعبارت جستجو: q= allinlinks%3A+Google+search |
| جستجوی عبارت | |
|---|---|
| توضیحات | عبارت جستجوی عبارت (") به شما امکان میدهد با قرار دادن عبارات در علامت نقل قول یا اتصال آنها با خط فاصله، عبارات کامل را جستجو کنید. نسخه URL-escaped شده از جستجوی عبارات به ویژه در صورتی مفید است که به دنبال نقل قولهای معروف یا نامهای خاص باشید. همچنین میتوانید از پارامتر درخواست as_epq برای ارسال جستجوی عبارت استفاده کنید. |
| مثالها | ورودی کاربر: "Abraham Lincoln"عبارت جستجو: q= %22Abraham+Lincoln%22 |
| اطلاعات سند وب [info:] | |
|---|---|
| توضیحات | عبارت جستجو شده در نسخه URL-escaped از توجه: هنگام استفاده از |
| مثالها | ورودی کاربر: info:www.google.comعبارت جستجو: q= info%3Awww.google.com |
نمونه سوالات تصویری
مثالهای زیر چند درخواست HTTP تصویر را نشان میدهند تا نحوه استفاده از پارامترهای مختلف پرسوجو را نشان دهند. تعاریف پارامترهای مختلف پرسوجو در بخشهای «تعاریف پارامترهای پرسوجوی تصویر» این سند ارائه شده است.
این درخواست، ۵ نتیجه اول ( start=0&num=5 ) را برای عبارت جستجوی "monkey" ( q=monkey ) با نوع فایل .png درخواست میکند. در نهایت، این جستجو مقادیری را برای پارامترهای client ، output و cx مشخص میکند که هر سه مورد الزامی هستند.
http://www.google.com/cse? searchtype=image start=0 &num=5 &q=monkey &as_filetype=png &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
پارامترهای جستجوی تصویر
| as_filetype | |
|---|---|
| توضیحات | اختیاری . تصاویری از نوع مشخص شده را برمیگرداند. مقادیر مجاز عبارتند از: |
| مثالها | q=google&as_filetype=png |
| imgsz | |
|---|---|
| توضیحات | اختیاری . تصاویری با اندازه مشخص را برمیگرداند، که در آن اندازه میتواند یکی از موارد زیر باشد:
|
| مثالها | q=google&as_filetype=png&imgsz=icon |
| نوع تصویر | |
|---|---|
| توضیحات | اختیاری . تصاویری از یک نوع را برمیگرداند که میتواند یکی از موارد زیر باشد:
|
| مثالها | q=google&as_filetype=png&imgtype=photo |
| ایمجیسی | |
|---|---|
| توضیحات | اختیاری . تصاویر سیاه و سفید، خاکستری یا رنگی را برمیگرداند:
|
| مثالها | q=google&as_filetype=png&imgc=gray |
| رنگ تصویر | |
|---|---|
| توضیحات | اختیاری . تصاویری از یک رنگ غالب خاص را برمیگرداند:
|
| مثالها | q=google&as_filetype=png&imgcolor=yellow |
| as_rights | |
|---|---|
| توضیحات | اختیاری . فیلترها بر اساس مجوز. مقادیر پشتیبانی شده عبارتند از:
|
| مثالها | q=cats&as_filetype=png&as_rights=cc_attribute |
محدودیتهای درخواست
نمودار زیر محدودیتهای مربوط به درخواستهای جستجویی که به گوگل ارسال میکنید را فهرست میکند:
| کامپوننت | حد | نظر دهید |
|---|---|---|
| طول درخواست جستجو | ۲۰۴۸ بایت | |
| تعداد عبارات پرسوجو | ۱۰ | شامل عباراتی با پارامترهای زیر است: q ، as_epq ، as_eq ، as_lq ، as_oq ، as_q |
| تعداد نتایج | ۲۰ | اگر پارامتر num را روی عددی بزرگتر از 20 تنظیم کنید، فقط 20 نتیجه برگردانده میشود. برای دریافت نتایج بیشتر، باید چندین درخواست ارسال کنید و مقدار پارامتر start را با هر درخواست افزایش دهید. |
بینالمللیسازی پرسوجوها و ارائه نتایج
سرویس جستجوی وب گوگل (Google WebSearch) شما را قادر میسازد تا اسناد را به چندین زبان جستجو کنید. میتوانید کدگذاری کاراکتری را که باید برای تفسیر درخواست HTTP و کدگذاری پاسخ XML شما استفاده شود (با استفاده از پارامترهای جستجوی ie و oe ) مشخص کنید. همچنین میتوانید نتایج را فیلتر کنید تا فقط اسناد نوشته شده به زبانهای خاص را شامل شود.
بخشهای زیر مسائل مربوط به جستجو در چندین زبان را مورد بحث قرار میدهند:
رمزگذاری کاراکتر
سرورها دادههایی مانند صفحات وب را به عنوان دنباله ای از بایتهای رمزگذاری شده به مرورگرها ارسال میکنند. سپس مرورگر بایتها را به دنباله ای از کاراکترها رمزگشایی میکند. هنگام ارسال درخواست به سرویس WebSearch، میتوانید طرحهای رمزگذاری را هم برای عبارت جستجوی خود و هم برای پاسخ XML دریافتی مشخص کنید.
شما میتوانید از پارامتر درخواست ie برای مشخص کردن مکانیزم کدگذاری کاراکترهای درخواست HTTP خود استفاده کنید. همچنین میتوانید از پارامتر oe برای مشخص کردن طرح کدگذاری که گوگل باید برای کدگذاری پاسخ XML شما استفاده کند، استفاده کنید. اگر از طرح کدگذاری دیگری غیر از ISO-8859-1 (یا latin1 ) استفاده میکنید، لطفاً مطمئن شوید که مقادیر صحیح را برای پارامترهای ie و oe مشخص میکنید.
نکته: اگر قابلیت جستجو را برای چندین زبان ارائه میدهید، توصیه میکنیم از مقدار کدگذاری utf8 (UTF-8) برای هر دو پارامتر ie و oe استفاده کنید.
برای مشاهده لیست کاملی از مقادیری که میتوانید برای پارامترهای ie و oe استفاده کنید، لطفاً به پیوست «طرحهای کدگذاری کاراکتر» مراجعه کنید.
برای اطلاعات عمومی بیشتر در مورد کدگذاری کاراکتر، لطفاً به آدرس http://www.w3.org/TR/REC-html40/charset.html مراجعه کنید.
زبانهای رابط
شما میتوانید از پارامتر درخواست hl برای شناسایی زبان رابط گرافیکی خود استفاده کنید. مقدار پارامتر hl ممکن است بر نتایج جستجوی XML تأثیر بگذارد، به خصوص در پرسوجوهای بینالمللی که محدودیت زبان (با استفاده از پارامتر lr ) به صراحت مشخص نشده است. در چنین مواردی، پارامتر hl ممکن است نتایج جستجو را به همان زبانی که زبان ورودی کاربر است، ارتقا دهد.
پیشنهاد میکنیم پارامتر hl را در نتایج جستجو به طور صریح تنظیم کنید تا مطمئن شوید گوگل برای هر عبارت جستجو، باکیفیتترین نتایج را انتخاب میکند.
برای مشاهده لیست کاملی از مقادیر معتبر برای پارامتر hl ، لطفاً به بخش زبانهای رابط پشتیبانیشده مراجعه کنید.
جستجوی اسناد نوشته شده به زبانهای خاص
شما میتوانید از پارامتر درخواست lr برای محدود کردن نتایج جستجو به اسنادی که به یک زبان خاص یا مجموعهای از زبانها نوشته شدهاند، استفاده کنید.
پارامتر lr از عملگرهای بولی پشتیبانی میکند تا به شما امکان دهد چندین زبان را که باید در نتایج جستجو گنجانده شوند (یا حذف شوند) مشخص کنید.
مثالهای زیر نشان میدهند که چگونه میتوانید از عملگرهای بولی برای درخواست اسناد به زبانهای مختلف استفاده کنید.
برای اسنادی که به زبان ژاپنی نوشته شدهاند:
lr=lang_jp
برای اسنادی که به زبان ایتالیایی یا آلمانی نوشته شدهاند:
lr=lang_it|lang_de
برای اسنادی که به زبان مجاری یا چکی نوشته نشدهاند:
lr=(-lang_hu).(-lang_cs)
لطفاً برای مشاهده لیست کاملی از مقادیر ممکن برای پارامتر lr به بخش « مقادیر مجموعه زبان» و برای بحث کامل در مورد استفاده از این عملگرها به بخش « عملگرهای بولی» مراجعه کنید.
جستجوی چینی سادهشده و سنتی
چینی سادهشده و چینی سنتی دو گونه نوشتاری زبان چینی هستند. یک مفهوم واحد ممکن است در هر گونه به طور متفاوتی نوشته شود. با توجه به جستجویی در یکی از گونهها، سرویس جستجوی وب گوگل میتواند نتایجی را ارائه دهد که شامل صفحاتی در هر دو گونه باشد.
برای استفاده از این ویژگی:
- پارامتر درخواست c2coff را روی ۰ تنظیم کنید.
و - یکی از موارد زیر را انجام دهید:
مثال زیر پارامترهای پرسوجویی را که باید در درخواست نتایج وارد کنید، به هر دو زبان چینی ساده و سنتی نشان میدهد. (توجه داشته باشید که اطلاعات مورد نیاز اضافی، مانند کلاینت ، در این مثال گنجانده نشده است.)
search?hl=zh-CN
&lr=lang_zh-TW|lang_zh-CN
&c2coff=0فیلتر کردن نتایج
جستجوی وب گوگل روشهای مختلفی برای فیلتر کردن نتایج جستجو ارائه میدهد:
فیلتر خودکار نتایج جستجو
در تلاش برای ارائه بهترین نتایج جستجوی ممکن، گوگل از دو تکنیک برای فیلتر کردن خودکار نتایج جستجویی که عموماً نامطلوب تلقی میشوند، استفاده میکند:
محتوای تکراری - اگر چندین سند حاوی اطلاعات یکسانی باشند، فقط مرتبطترین سند از آن مجموعه در نتایج جستجوی شما نمایش داده میشود.
ازدحام میزبان - اگر نتایج جستجوی زیادی از یک سایت وجود داشته باشد، گوگل ممکن است تمام نتایج آن سایت را نشان ندهد یا ممکن است نتایج را با درصد کمتری نشان دهد.
رتبهای که در غیر این صورت میتوانستند داشته باشند.
توصیه میکنیم این فیلترها را برای درخواستهای جستجوی معمولی فعال بگذارید زیرا فیلترها کیفیت اکثر نتایج جستجو را به میزان قابل توجهی افزایش میدهند. با این حال، میتوانید با تنظیم پارامتر جستجوی فیلتر روی ۰ در درخواست جستجوی خود، از این فیلترهای خودکار عبور کنید.
فیلتر کردن زبان و کشور
سرویس جستجوی وب گوگل نتایج را از یک فهرست اصلی از تمام اسناد وب برمیگرداند. این فهرست اصلی شامل زیرمجموعههایی از اسناد است که بر اساس ویژگیهای خاص، از جمله زبان و کشور مبدا، گروهبندی شدهاند.
شما میتوانید از پارامترهای درخواست lr و cr برای محدود کردن نتایج جستجو به زیرمجموعههایی از اسناد که به ترتیب به زبانهای خاص نوشته شدهاند یا از کشورهای خاص سرچشمه میگیرند، استفاده کنید.
جستجوی وب گوگل با تجزیه و تحلیل موارد زیر، زبان یک سند را تعیین میکند:
- دامنه سطح بالا (TLD) مربوط به URL سند
- متا تگهای زبان در سند
- زبان اصلی مورد استفاده در متن اصلی سند
Please also see the definition of the lr parameter, the section on Searching for Documents Written in Specific Languages and the Language Collection Values that can be used as values for the lr parameter for more information on restricting results based on language.
Google WebSearch determines the country of a document by analyzing:
- the top-level domain (TLD) of the document's URL
- the geographic location of the Web server's IP address
Please also see the definition of the cr parameter and the Country Collection Values that can be used as values for the cr parameter for more information on restricting results by country of origin.
Note: You can combine language values and country values to customize your search results. For example, you could request documents that are written in French and come from France or Canada, or you could request documents that come from Holland and are not written in English. The lr and cr parameters both support Boolean Operators .
Filtering Adult Content with SafeSearch
Many Google customers do not want to display search results for sites that contain adult content. Using our SafeSearch filter, you can screen for search results that contain adult content and eliminate them. Google's filters use proprietary technology to check keywords, phrases and URLs. While no filters are 100 percent accurate, SafeSearch will remove the overwhelming majority of adult content from your search results.
Google strives to keep SafeSearch as current and comprehensive as possible by continually crawling the Web and by incorporating updates from user suggestions.
SafeSearch is available in the following languages:
| هلندی انگلیسی فرانسوی آلمانی | ایتالیایی پرتغالی (برزیلی) اسپانیایی چینی سنتی |
You can adjust the degree to which Google filters your results for adult content using the safe query parameter. The following table explains Google's SafeSearch settings and how those settings will affect your search results:
| SafeSearch Level | توضیحات |
|---|---|
| بالا | Enables a stricter version of safe search. |
| متوسط | Blocks web pages containing pornography and other explicit sexual content. |
| خاموش | Does not filter adult content from search results. |
* The default SafeSearch setting is off .
If you have SafeSearch activated and you find sites that contain offensive content in your results, please email the site's URL to safesearch@google.com , and we will investigate the site.
XML Results
- Google XML Results DTD
- About the XML Response
- XML Results for Regular and Advanced Search Queries
- Regular/Advanced Search: Sample Query and XML Result
- Regular/Advanced Search: XML Tags
Google XML Results DTD
Google uses the same DTD to describe the XML format for all types of search results. Many of the tags and attributes are applicable for all search types. Some tags, however, are applicable only for certain search types. Consequently, the definitions in the DTD may be less restrictive than the definitions given in this document.
This document describes those aspects of the DTD that are relevant for WebSearch. When you look at the DTD, if you're working on WebSearch, you can safely ignore tags and attributes that are not documented here. If the definition differs between the DTD and the documentation, that fact is noted in this document.
Google can return XML results either with or without a reference to the most recent DTD. The DTD is a guide to help search administrators and XML parsers understand Google's XML results. Because Google's XML grammar may change from time to time, you should not configure your parser to use the DTD to validate each XML result.
Additionally, you should not configure your XML parser to fetch the DTD each time you submit a search request. Google updates the DTD infrequently, and these requests create unnecessary delay and bandwidth requirements.
Google recommends that you use the xml_no_dtd output format to get XML results. If you specify the xml output format in your search request, the only difference is the inclusion of the following line in the XML results:
<!DOCTYPE GSP SYSTEM "google.dtd">You can access the latest DTD at http://www.google.com/google.dtd .
Please note that not all features in the DTD may be available or supported at this time.
About the XML Response
- All element values are valid HTML suitable for display unless otherwise noted in the XML tag definitions.
- Some element values are URLs that need to be HTML-encoded before they are displayed.
- Your XML parser should ignore undocumented attributes and tags. This allows your application to continue working without modification if Google adds more features to the XML output.
- Certain characters must be escaped when included as values in XML tags. Your XML processor should convert these entities back to the appropriate characters. If you do not convert entities properly, the browser may, for example, render the & character as "&". The XML Standard documents these characters; these characters are reproduced in the table below:
شخصیت Escaped Forms نهاد کد کاراکتر Ampersand و & & Single Quote ' ' ' Double Quote « " " بزرگتر از > > > کمتر از < &آن؛ <
XML Results for Regular and Advanced Search Queries
Regular/Advanced Search: Sample Query and XML Result
This sample WebSearch request asks for 10 results ( num=10 ) about the search term "socer" ( q=socer ), which is the word "soccer" intentionally spelled wrong for this example.)
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
This request yields the XML result below. Note that there are several comments in the XML result to indicate where certain tags not included in the result would appear.
<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>
<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>
Regular/Advanced Search: XML Tags
XML responses for regular search requests and advanced search requests both use the same set of XML tags. These XML tags are shown in the XML example above and explained in the tables below.
The XML tags below are listed alphabetically by tag name, and each tag definition contains a description of the tag, an example showing how the tag would appear in an XML result and the format of the tag's content. If the tag is a subtag of another XML tag or if the tag has subtags or attributes of its own, that information is also provided in the tag's definition table.
Certain symbols may be displayed next to some subtags in the definitions below. These symbols, and their meanings, are:
* = zero or more instances of the subtag
+ = one or more instances of the subtag
| الف | ب | سی | دی | ف | جی | ح | من | ل | م | ن | پ | س | ر | س | تی | یو | ایکس |
| anchor_text | |
|---|---|
| تعریف | The <anchor_text> tag specifies the text that you should display to users to identify a refinement label associated with a search result set. Since refinement labels replace nonalphanumeric characters with underscores, you should not display the value of the <label> tag in your user interface. Instead, you should display the value of the <anchor_text> tag. |
| مثال | <anchor_text>golf courses</anchor_text> |
| Subtag of | FacetItem |
| Content Format | متن |
| BLOCK | |
|---|---|
| تعریف | This tag encapsulates the contents of a block in a body line of a promotion result. Each block has subtags T , U , and L . A nonempty T tag denotes that the block contains text; nonempty U and L tags denote that the block contains a link (with URL given in the U subtag and anchor text in the L subtag). |
| Subtags | T , U , L |
| Subtag of | BODY_LINE |
| Content Format | خالی |
| BODY_LINE | |
|---|---|
| تعریف | This tag encapsulates the contents of a line in the body of promoted result. Each body line consists of several BLOCK tags, which either contain some text or a link with URL and anchor text. |
| Subtags | BLOCK * |
| Subtag of | SL_MAIN |
| Content Format | خالی |
| سی | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| تعریف | The <C> tag indicates that the WebSearch service can retrieve a cached version of this search result URL. You cannot retrieve cached pages through the XML API, but you can redirect users to www.google.com for this content. | |||||||||
| ویژگیها |
| |||||||||
| مثال | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
| Subtag of | دارد | |||||||||
| Content Format | خالی | |||||||||
| C2C | |
|---|---|
| تعریف | The <C2C> tag indicates that the result refers to a Traditional Chinese language page. This tag appears only when Simplified and Traditional Chinese Search is enabled. See the c2coff query parameter definition for more information about enabling and disabling this feature. |
| Content Format | متن |
| زمینه | |
|---|---|
| تعریف | The <Context> tag encapsulates a list of refinement labels associated with a set of search results. |
| مثال | <Context> |
| Subtags | title , Facet + |
| Content Format | کانتینر |
| CRAWLDATE | |
|---|---|
| تعریف | The <CRAWLDATE> tag identifies the date that the page was last crawled. |
| مثال | <CRAWLDATE>May 21, 2005</CRAWLDATE> |
| Subtag of | ر |
| Content Format | متن |
| دی | |
|---|---|
| تعریف | The <DI> tag encapsulates Open Directory Project (ODP) category information for a single search result. |
| مثال | <DI> |
| Subtags | DT ?, DS ? |
| Subtag of | دارد |
| Content Format | خالی |
| دیاس | |
|---|---|
| تعریف | The <DS> tag provides the summary listed for a single category in the ODP directory. |
| مثال | <DS>Post your <b>soccer</b> resume directly on the Internet.</DS> |
| Subtag of | دی |
| Content Format | Text (may contain HTML) |
| دی تی | |
|---|---|
| تعریف | The <DT> tag provides the title for a single category listed in the ODP directory. |
| مثال | <DT>SoccerConnection.net</DT> |
| Subtag of | دی |
| Content Format | Text (may contain HTML) |
| Facet | |
|---|---|
| تعریف | The <Facet> tag contains a logical grouping of <FacetItem> tags. You can create these groupings using the Programmable Search Engine Engine XML Specification format . If you do not create these groupings, the results_xml_tag_Context><Context> tag will contain up to four <Facet> tags. The items within each <Facet> tag will be grouped for display purposes but may not have a logical relationship. |
| مثال | <Facet> |
| Subtags | FacetItem +, title + |
| Subtag of | زمینه |
| Content Format | کانتینر |
| FacetItem | |
|---|---|
| تعریف | The <FacetItem> tag encapsulates information about a refinement label associated with a set of search results. |
| مثال | <FacetItem> |
| Subtags | label , anchor_text + |
| Subtag of | Facet |
| Content Format | FacetItem |
| اف آی | |
|---|---|
| تعریف | The <FI> tag serves as a flag that indicates whether document filtering was performed for the search. See the Automatic Filtering section of this document for more information about Google's search results filters. |
| مثال | <FI /> |
| Subtag of | RES |
| Content Format | خالی |
| GSP | |||||||
|---|---|---|---|---|---|---|---|
| تعریف | The <GSP> tag encapsulates all data returned in Google XML search results. "GSP" is an abbreviation for "Google Search Protocol". | ||||||
| ویژگیها |
| ||||||
| مثال | <GSP VER="3.2"> | ||||||
| Subtags | PARAM +, Q , RES ?, TM | ||||||
| Content Format | خالی | ||||||
| دارد | |
|---|---|
| تعریف | The <HAS> tag encapsulates information about any special search request parameters supported for a particular URL. Note: The definition of <HAS> for WebSearch is more restrictive than in the DTD . |
| Subtags | DI ?, L ?, C ?, RT ? |
| Subtag of | ر |
| ISURL | |
|---|---|
| تعریف | Google returns the <ISURL> tag if the associated search query is a URL. |
| Subtag of | GSP |
| Content Format | خالی |
| ل | |
|---|---|
| تعریف | The presence of the <L> tag indicates that the WebSearch service can find other sites that link to this search result URL. To find such sites, you would use the link: special query term. |
| Subtag of | دارد |
| Content Format | خالی |
| برچسب | |
|---|---|
| تعریف | The <label> tag specifies a refinement label that you can use to filter the search results that you receive. To use a refinement label, add the string more: [[label tag value]] to the value of the q parameter in your HTTP request to Google as shown in the following example. Please note that this value must be URL-escaped before you send the query to Google. This example uses the refinement label golf_courses to Note: The <label> tag is not the same as the <Label> tag, which identifies a refinement label associated with a particular URL in your search results. |
| مثال | <label>golf_courses</label> |
| Subtag of | FacetItem |
| Content Format | متن |
| لانگ | |
|---|---|
| تعریف | The <LANG> tag contains Google's best guess of the language of the search result. |
| مثال | <LANG>en</LANG> |
| Subtag of | ر |
| Content Format | متن |
| م | |
|---|---|
| تعریف | The <M> tag identifies the estimated total number of results for the search. Note: This estimate may not be accurate. |
| مثال | <M>16200000</M> |
| Subtag of | RES |
| Content Format | متن |
| توجه | |
|---|---|
| تعریف | The <NB> tag encapsulates navigation information—links to the next page of search results or the previous page of search results—for the result set. Note: This tag is only present if more results are available. |
| مثال | <NB> |
| Subtags | NU ?, PU ? |
| Subtag of | RES |
| Content Format | خالی |
| نو | |
|---|---|
| تعریف | The <NU> tag contains a relative link to the next page of search results. |
| مثال | <NU>/search?q=flowers&num=10&hl=en&ie=UTF-8 &output=xml&client=test&start=10</NU> |
| Subtag of | توجه |
| Content Format | Text (Relative URL) |
| PARAM | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| تعریف | The <PARAM> tag identifies an input parameter submitted in the HTTP request associated with the XML result. Information about the parameter is contained in the tag attributes—name, value, original_value—and there will be one PARAM tag for each parameter submitted in the HTTP request. | ||||||||||||
| ویژگیها |
| ||||||||||||
| مثال | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
| Subtag of | GSP | ||||||||||||
| Content Format | مجتمع | ||||||||||||
| پلوتونیم | |
|---|---|
| تعریف | The <PU> tag provides a relative link to the previous page of search results. |
| مثال | <PU>/search?q=flowers&num=10&hl=en&output=xml &client=test&start=10</PU> |
| Subtag of | توجه |
| Content Format | Text (Relative URL) |
| س | |
|---|---|
| تعریف | The <Q> tag identifies the search query submitted in the HTTP request associated with the XML result. |
| مثال | <Q>pizza</Q> |
| Subtag of | GSP |
| Content Format | متن |
| ر | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| تعریف | The <R> tag encapsulates the details of an individual search result. Note: The definition of the <R> tag for WebSearch is more restrictive than in the DTD . | |||||||||
| ویژگیها |
| |||||||||
| Subtags | U , UE , T ?, CRAWLDATE , S ?, LANG ?, HAS | |||||||||
| Subtag of | RES | |||||||||
| RES | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| تعریف | The <RES> tag encapsulates the set of individual search results and details about those results. | |||||||||
| ویژگیها |
| |||||||||
| مثال | <RES SN="1" EN="10"> | |||||||||
| Subtags | M , FI ?, XT ?, NB ?, R * | |||||||||
| Subtag of | GSP | |||||||||
| Content Format | خالی | |||||||||
| س | |
|---|---|
| تعریف | The <S> tag contains an excerpt for a search result that shows query terms highlighted in bold. Line breaks are included in the excerpt for proper text wrapping. |
| مثال | <S>Washington (CNN) -- A bid to end the Senate standoff over President <b>Bush's</b> judicial picks would let five nominees advance to a final vote while preserving the <b>...<b>...</b><S> |
| Subtag of | ر |
| Content Format | Text (HTML) |
| SL_MAIN | |
|---|---|
| تعریف | This tag encapsulates the contents of a promotion result. Use for parsing promotions. The anchor text and URL of the title link are contained in T and U subtags respectively. The lines of body text and links are contained in BODY_LINE subtags. |
| Subtags | BODY_LINE *, T , U |
| Subtag of | SL_RESULTS |
| Content Format | خالی |
| SL_RESULTS | |
|---|---|
| تعریف | Container tag for promoted results. One of these will appear whenever you have a promotion in your search results. The SL_MAIN subtag contains the main result data. |
| Subtags | SL_MAIN * |
| Subtag of | ر |
| Content Format | خالی |
| املا | |
|---|---|
| تعریف | The <Spelling> tag encapsulates an alternate spelling suggestion for the submitted query. This tag only appears on the first page of search results. Spelling suggestions are available in English, Chinese, Japanese and Korean. Note: Google will only return spelling suggestions for queries where the gl parameter value is in lowercase letters. |
| مثال | <Spelling> |
| Subtags | پیشنهاد |
| Subtag of | GSP |
| Content Format | خالی |
| پیشنهاد | |||||||
|---|---|---|---|---|---|---|---|
| تعریف | The <Suggestion> tag contains an alternate spelling suggestion for the submitted query. You can use the tag's content to suggest the alternate spelling to your search user. The value of the q attribute is the URL-escaped spelling suggestion that you can use as a query term. | ||||||
| ویژگیها |
| ||||||
| مثال | <Suggestion q="soccer"><b><i>soccer</i></b></Suggestion> | ||||||
| Subtag of | املا | ||||||
| Content Format | Text (HTML) | ||||||
| تی | |
|---|---|
| تعریف | The <T> tag contains the title of the result. |
| مثال | <T>Amici's East Coast Pizzeria</T> |
| Subtag of | ر |
| Content Format | Text (HTML) |
| عنوان | |
|---|---|
| تعریف | As a child of <Context> , the <title> tag contains the name of your Programmable Search Engine. As a child of <Facet> , the <title> tag provides a title for a set of facets. |
| مثال | As a child of <Context>: <title>My Search Engine</title> As a child of <Facet>: <title>facet title</title> |
| Subtag of | Context , Facet |
| Content Format | متن |
| ™ | |
|---|---|
| تعریف | The <TM> tag identifies the total server time needed to return search results, measured in seconds. |
| مثال | <TM>0.100445</TM> |
| Subtag of | GSP |
| Content Format | Text (Floating-point number) |
| تی تی | |
|---|---|
| تعریف | The <TT> tag provides a search tip. |
| مثال | <TT><i>Tip: For most browsers, pressing the Return key produces the same results as clicking the Search button.</i></TT> |
| Subtag of | GSP |
| یو | |
|---|---|
| تعریف | The <U> tag provides the URL of the search result. |
| مثال | <U>http://www.dominos.com/</U> |
| Subtag of | ر |
| Content Format | Text (Absolute URL) |
| یو دی | |
|---|---|
| تعریف | The <UD> tag provides the IDN-encoded (International Domain Name) URL for the search result. The value allows domains to be displayed using local languages. For example, the IDN-encoded URL http://www.%E8%8A%B1%E4%BA%95.com could be decoded and displayed as http://www.花井鮨.com . This <UD> tag will only be included in search results for requests that included the ud parameter. Note: This is a beta feature. |
| مثال | <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD> |
| Subtag of | ر |
| Content Format | Text (IDN-encoded URL) |
| اتحادیه اروپا | |
|---|---|
| تعریف | The <UE> tag provides the URL of the search result. The value is URL-escaped so that it is suitable for passing as a query parameter in a URL. |
| مثال | <UE>http://www.dominos.com/</UE> |
| Subtag of | ر |
| Content Format | Text (URL-escaped URL) |
| ایکس تی | |
|---|---|
| تعریف | The <XT> tag indicates that the estimated total number of results, as specified by the M tag, actually represents the exact total number of results. See the Automatic Filtering section of this document for more details. |
| مثال | <XT /> |
| Subtag of | RES |
| Content Format | خالی |
XML Results for Image Search Queries
This sample Image request asks for 5 results (num=5) about the search term "monkey" (q=monkey).
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
This request yields the XML result below.
<GSP VER="3.2">
<TM>0.395037</TM>
<Q>monkeys</Q>
<PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
<PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
<PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
<PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
<PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
<PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
<PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
<PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
<PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>
<Context>
<title>domestigeek</title>
</Context>
<ARES/>
<RES SN="1" EN="2">
<M>2500000</M>
<NB>
<NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
&ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
</NU>
</NB>
<RG START="1" SIZE="2"/>
<R N="1" MIME="image/jpeg">
<RU>http://www.flickr.com/photos/fncll/135465558/</RU>
<U>
http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
</U>
<UE>
http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
</UE>
<T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
<RK>0</RK>
<BYLINEDATE>1146034800</BYLINEDATE>
<S>Computer <b>Monkeys</b> | Flickr</S>
<LANG>en</LANG>
<IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
<SZ>88386</SZ>
<IN/>
</IMG>
<TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
</R>
<R N="2" MIME="image/jpeg">
<RU>
http://www.flickr.com/photos/flickerbulb/187044366/
</RU>
<U>
http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
</U>
<UE>
http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
</UE>
<T>
one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
</T>
<RK>0</RK>
<BYLINEDATE>1152514800</BYLINEDATE>
<S>one. ugly. <b>monkey</b>.</S>
<LANG>en</LANG>
<IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
EF4tQQnDDKOq0"><SZ>58339</SZ>
<IN/>
</IMG>
<TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
</R>
</RES>
</GSP>Image Search: XML Tags
The table below shows additional XML tags used in XML responses for image search queries.
Certain symbols may be displayed next to some subtags in the definitions below. These symbols, and their meanings, are:
* = zero or more instances of the subtag
+ = one or more instances of the subtag
| آر جی | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| تعریف | The <RG> tag encloses the details of an individual image search result. | |||||||||
| ویژگیها |
| |||||||||
| Subtag of | RES | |||||||||
| آر یو | |
|---|---|
| تعریف | The <RU tag> tag encloses details of each image search result. |
| Subtag of | ر |