این صفحه به نسخه XML جستجوی سفارشی JSON API اشاره دارد که فقط برای مشتریان جستجوی سایت Google در دسترس است.
- بررسی اجمالی
- فرمت درخواست موتور جستجو قابل برنامه ریزی
- نتایج XML
بررسی اجمالی
سرویس Google WebSearch به مشتریان جستجوی سایت Google امکان می دهد نتایج جستجوی Google را در وب سایت های خود نمایش دهند. سرویس WebSearch از یک پروتکل ساده مبتنی بر HTTP برای ارائه نتایج جستجو استفاده می کند. مدیران جستجو کنترل کاملی بر نحوه درخواست نتایج جستجو و نحوه ارائه آن نتایج به کاربر نهایی دارند. این سند جزئیات فنی درخواست جستجوی Google و قالبهای نتایج را شرح میدهد.
برای بازیابی نتایج جستجوی وب گوگل، برنامه شما یک درخواست HTTP ساده به گوگل ارسال می کند. سپس گوگل نتایج جستجو را در قالب XML برمی گرداند. نتایج با فرمت XML به شما این امکان را می دهد که نحوه نمایش نتایج جستجو را سفارشی کنید.
فرمت درخواست جستجوی وب
- درخواست بررسی اجمالی
- شرایط پرس و جو
- پارامترهای درخواست
- نمونه پرس و جوهای جستجوی وب
- تعاریف پارامترهای جستجوی وب
- نمونه پرس و جوهای تصویری
- تعاریف پارامتر جستجوی تصویر
- جستجوی پیشرفته
- پارامترهای جستجوی پیشرفته
- شرایط درخواست ویژه
- محدودیت های درخواست
درخواست بررسی اجمالی
درخواست جستجوی گوگل یک دستور استاندارد HTTP GET
است. این شامل مجموعه ای از پارامترهای مرتبط با پرس و جوهای شما است. این پارامترها در URL درخواست به صورت جفت های name=value که با نویسه های آمپر و (&) از هم جدا شده اند، گنجانده شده اند. پارامترها شامل دادههایی مانند عبارت جستجو و یک شناسه موتور منحصر به فرد ( cx
) است که موتوری را که درخواست HTTP را ارسال میکند، شناسایی میکند. سرویس WebSearch یا Image Search نتایج XML را در پاسخ به درخواستهای HTTP شما برمیگرداند.
شرایط پرس و جو
اکثر درخواست های جستجو شامل یک یا چند عبارت پرس و جو هستند. یک عبارت پرس و جو به عنوان مقدار یک پارامتر در درخواست جستجو ظاهر می شود.
عبارات پرس و جو می توانند انواع مختلفی از اطلاعات را برای فیلتر کردن و سازماندهی نتایج جستجویی که Google برمی گرداند مشخص کنند. کوئری ها می توانند مشخص کنند:
- کلمات یا عباراتی که باید شامل یا حذف شوند
- همه کلمات در یک عبارت جستجو (پیشفرض)
- یک عبارت دقیق در عبارت جستجو
- هر کلمه یا عبارتی در یک عبارت جستجو
- کجای یک سند برای جستجوی عبارات جستجو
- هر جایی در سند (پیشفرض)
- فقط در متن سند
- فقط در عنوان سند
- فقط در آدرس سند
- فقط در پیوندهای موجود در سند
- محدودیت در خود اسناد
- شامل یا حذف اسناد از انواع فایل های خاص (مانند فایل های PDF یا اسناد Word)
- جستارهای URL ویژه که به جای جستجو، اطلاعات مربوط به یک URL داده شده را برمی گرداند
- جستارهایی که اطلاعات کلی در مورد یک URL، مانند دسته دایرکتوری باز، قطعه یا زبان آن را برمی گرداند
- جستارهایی که مجموعه ای از صفحات وب را که به یک URL پیوند دارند برمی گرداند
- پرس و جوهایی که مجموعه ای از صفحات وب را مشابه یک URL داده شده برمی گرداند
جستجوی پیش فرض
مقادیر پارامتر عبارت جستجو باید دارای URL-Escape باشد. توجه داشته باشید که علامت مثبت ("+") را برای هر دنباله فضای خالی در عبارت جستجو جایگزین کنید. این موضوع در بخش URL Escapeing این سند بیشتر مورد بحث قرار گرفته است.
عبارت جستجوی جستجو با استفاده از پارامتر q به سرویس WebSearch ارسال می شود. یک عبارت نمونه جستجو عبارت است از:
q=horses+cows+pigs
بهطور پیشفرض، سرویس جستجوی وب Google فقط اسنادی را برمیگرداند که شامل همه عبارتهای عبارت جستجو میشود.
پارامترهای درخواست
این بخش پارامترهایی را که می توانید هنگام درخواست جستجو استفاده کنید، فهرست می کند. پارامترها به دو لیست تقسیم می شوند. لیست اول شامل پارامترهایی است که به تمام درخواست های جستجو مربوط می شود. لیست دوم شامل پارامترهایی است که فقط مربوط به درخواست های جستجوی پیشرفته هستند.
سه پارامتر درخواست مورد نیاز است:
- پارامتر مشتری باید روی
google-csbe
تنظیم شود - پارامتر خروجی فرمت نتایج XML برگشتی را مشخص می کند. نتایج را می توان با (xml) یا بدون (
xml_no_dtd
) ارجاع به DTD Google برگرداند. توصیه می کنیم این مقدار را رویxml_no_dtd
تنظیم کنید. توجه: اگر این پارامتر را مشخص نکنید، نتایج به جای XML در HTML برگردانده می شوند. - پارامتر cx که نشان دهنده شناسه منحصر به فرد موتور است.
متداول ترین پارامترهای درخواستی غیر از موارد ذکر شده در بالا عبارتند از:
نمونه پرس و جوهای جستجوی وب
مثالهای زیر چند درخواست HTTP جستجوی وب را نشان میدهند تا نحوه استفاده از پارامترهای جستجوی مختلف را نشان دهند. تعاریف پارامترهای مختلف پرس و جو در بخش تعاریف پارامتر پرس و جوی WebSearch و پارامترهای جستجوی پیشرفته جستجوی این سند ارائه شده است.
این درخواست 10 نتیجه اول ( start=0&num=10
) را برای عبارت جستجوی "red sox" ( q=red+sox
) می خواهد. پرس و جو همچنین مشخص می کند که نتایج باید از وب سایت های کانادایی ( cr=countryCA
) و به زبان فرانسوی ( lr=lang_fr
) نوشته شود. در نهایت، کوئری مقادیری را برای پارامترهای کلاینت ، خروجی و 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
این مثال از برخی از پارامترهای جستجوی پیشرفته برای سفارشی کردن بیشتر پرس و جو استفاده می کند. این درخواست از پارامتر as_q ( as_q=red+sox
) به جای پارامتر q استفاده می کند. همچنین از پارامتر 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 | |||||||
---|---|---|---|---|---|---|---|
شرح | اختیاری . پارامتر c2coff ویژگی جستجوی ساده و سنتی چینی را فعال یا غیرفعال می کند. مقدار پیش فرض این پارامتر
| ||||||
مثال ها | q=google&c2coff=1 |
مشتری | |
---|---|
شرح | ضروری . پارامتر |
مثال ها | q=google&client=google-csbe |
cr | |
---|---|
شرح | اختیاری . پارامتر Google WebSearch کشور یک سند را با تجزیه و تحلیل:
برای فهرستی از مقادیر معتبر برای این پارامتر، بخش مقادیر پارامتر کشور (cr) را ببینید. |
مثال ها | q=Frodo&cr=countryNZ |
cx | |
---|---|
شرح | ضروری . پارامتر |
مثال ها | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
فیلتر | |||||||
---|---|---|---|---|---|---|---|
شرح | اختیاری . پارامتر فیلتر فیلتر کردن خودکار نتایج جستجوی گوگل را فعال یا غیرفعال می کند. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی Google، بخش فیلترینگ خودکار این سند را ببینید. مقدار پیشفرض پارامتر
توجه: بهطور پیشفرض، گوگل برای بهبود کیفیت آن نتایج، فیلتر را برای همه نتایج جستجو اعمال میکند. | ||||||
مثال ها | q=google&filter=0 |
gl | |
---|---|
شرح | اختیاری . مقدار پارامتر تعیین مقدار پارامتر |
مثال ها | این درخواست اسناد نوشته شده در بریتانیا را در نتایج جستجوی وب تقویت می کند: |
hl | |
---|---|
شرح | اختیاری . پارامتر برای اطلاعات بیشتر به بخش زبانهای رابط بینالمللی کردن پرسشها و ارائه نتایج و زبانهای رابط پشتیبانیشده برای فهرستی از زبانهای پشتیبانیشده مراجعه کنید. |
مثال ها | این درخواست تبلیغات برای شراب به زبان فرانسوی را هدف قرار می دهد. ( وین اصطلاح فرانسوی برای شراب است.) q=vin&ip=10.10.10.10&ad=w5& hl=fr |
hq | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | این درخواست عبارت "پیتزا" و "پنیر" را جستجو می کند. عبارت همان |
یعنی | |
---|---|
شرح | اختیاری . پارامتر برای بحث در مورد زمانی که ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش رمزگذاری کاراکتر مراجعه کنید. برای لیست |
مثال ها | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
شرح | اختیاری . پارامتر Google WebSearch زبان یک سند را با تجزیه و تحلیل زیر تعیین می کند:
برای فهرستی از مقادیر معتبر برای این پارامتر به بخش Language ( |
مثال ها | q=Frodo&lr=lang_en |
تعداد | |
---|---|
شرح | اختیاری . پارامتر مقدار پیش فرض توجه: اگر تعداد کل نتایج جستجو کمتر از تعداد نتایج درخواستی باشد، همه نتایج جستجوی موجود برگردانده می شوند. |
مثال ها | q=google& num=10 |
oe | |
---|---|
شرح | اختیاری . پارامتر برای بحث در مورد زمانی که ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش رمزگذاری کاراکتر مراجعه کنید. برای لیست مقادیر |
مثال ها | q=google&ie=utf8& oe=utf8 |
خروجی | |||||||
---|---|---|---|---|---|---|---|
شرح | ضروری . پارامتر
| ||||||
مثال ها | output=xml_no_dtd |
q | |
---|---|
شرح | اختیاری . پارامتر همچنین تعدادی عبارت پرس و جو ویژه وجود دارد که می تواند به عنوان بخشی از مقدار پارامتر کنترل پنل جستجوی Google شامل گزارشی از درخواست های برتر ارسال شده با استفاده از پارامتر توجه: مقدار مشخص شده برای پارامتر q باید URL-escape شده باشد. |
مثال ها | q=vacation &as_oq=london+paris |
بی خطر | |||||||||
---|---|---|---|---|---|---|---|---|---|
شرح | اختیاری . پارامتر
برای جزئیات بیشتر در مورد این ویژگی به بخش فیلتر کردن محتوای بزرگسالان با جستجوی ایمن مراجعه کنید. | ||||||||
مثال ها | q=adult&safe=high |
شروع کنید | |
---|---|
شرح | اختیاری . پارامتر پارامتر |
مثال ها | start=10 |
مرتب سازی | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | |
ud | |
---|---|
شرح | اختیاری . پارامتر 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 | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | موارد زیر محدوده جستجوی 5 تا 10 را شامل میشود: |
as_nhi | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | موارد زیر محدوده جستجوی 5 تا 10 را شامل میشود: |
as_oq | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | |
as_q | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | |
as_qdr | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | این مثال نتایج سال گذشته را درخواست می کند: این نمونه درخواست نتایج مربوط به 10 روز گذشته: |
as_sitesearch | |
---|---|
شرح | اختیاری . پارامتر |
مثال ها | |
شرایط درخواست ویژه
جستجوی وب گوگل امکان استفاده از چندین عبارت جستجوی خاص را می دهد که به قابلیت های اضافی موتور جستجوی گوگل دسترسی دارد. این عبارات پرس و جوی خاص باید در مقدار پارامتر درخواست q گنجانده شوند. مانند سایر اصطلاحات پرس و جو، اصطلاحات پرس و جوی خاص باید دارای URL-escape شوند. تعدادی از اصطلاحات پرس و جوی خاص حاوی دو نقطه (:) هستند. این کاراکتر نیز باید دارای URL-escape باشد. مقدار URL آن %3A
است.
پیوندهای برگشتی [لینک:] | |
---|---|
شرح | نسخه URL-Escape شده همچنین می توانید از پارامتر درخواست as_lq برای ارسال یک توجه: هنگام استفاده از |
مثال ها | |
جستجوی بولی یا جستجو [OR] | |
---|---|
شرح | عبارت همچنین می توانید از پارامتر درخواست as_oq برای ارسال جستجو برای هر عبارت در مجموعه ای از عبارات استفاده کنید. توجه: اگر یک درخواست جستجو عبارت "London+OR+Paris" را مشخص کند، نتایج جستجو شامل اسنادی می شود که حداقل یکی از آن دو کلمه را شامل می شود. در برخی موارد، اسناد موجود در نتایج جستجو ممکن است حاوی هر دو کلمه باشند. |
مثال ها | جستجو برای لندن یا پاریس: ورودی کاربر: 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 |
استثناء عبارت جستجو [-] | |
---|---|
شرح | عبارت query exclude ( نسخه بدون URL عبارت exclude query زمانی مفید است که یک عبارت جستجو بیش از یک معنی داشته باشد. به عنوان مثال، کلمه "باس" می تواند نتایجی را در مورد ماهی یا موسیقی ارائه دهد. اگر به دنبال اسنادی درباره ماهی بودید، میتوانید با استفاده از عبارت جستجوی حذف، اسناد مربوط به موسیقی را از نتایج جستجو حذف کنید. همچنین می توانید از پارامتر درخواست as_eq برای حذف اسناد منطبق با یک کلمه یا عبارت خاص از نتایج جستجو استفاده کنید. |
مثال ها | ورودی کاربر: bass -music عبارت جستجو: q=bass+ %2Dmusic |
حذف نوع فایل [ -filetype: ] | |
---|---|
شرح | عبارت پرس و جو نسخه URL-escape توجه: میتوانید چندین نوع فایل را با افزودن عبارتهای جستجوی انواع فایل های پشتیبانی شده توسط گوگل عبارتند از:
ممکن است در آینده انواع فایل های اضافی اضافه شود. یک لیست بهروز را میتوانید همیشه در سؤالات متداول نوع فایل Google پیدا کنید. |
مثال ها | این مثال اسنادی را برمیگرداند که «Google» را ذکر کردهاند اما اسناد PDF نیستند: این مثال اسنادی را برمیگرداند که «Google» را ذکر کردهاند، اما اسناد PDF و Word را حذف میکنند: |
نوع فایل فیلتر کردن [نوع فایل: ] | |
---|---|
شرح | نسخه URL-Escape از میتوانید نتایج جستجو را به اسنادی محدود کنید که با یکی از چندین پسوند فایل مطابقت دارند، با افزودن عبارتهای جستجوی به طور پیش فرض، نتایج جستجو شامل اسنادی با هر پسوند فایلی می شود. انواع فایل های پشتیبانی شده توسط گوگل عبارتند از:
ممکن است در آینده انواع فایل های اضافی اضافه شود. یک لیست بهروز را میتوانید همیشه در سؤالات متداول نوع فایل Google پیدا کنید. |
مثال ها | این مثال اسناد PDF را که "Google" را ذکر کرده اند برمی گرداند: این مثال اسناد PDF و Word را که "Google" را ذکر کرده اند، برمی گرداند: |
شامل عبارت پرس و جو [+] | |
---|---|
شرح | عبارت پرس و جو شامل (+) مشخص می کند که یک کلمه یا عبارت باید در تمام اسناد موجود در نتایج جستجو وجود داشته باشد. برای استفاده از عبارت عبارت include query، باید کلمه یا عبارتی را که باید در همه نتایج جستجو گنجانده شود، با "+" (یک علامت مثبت) وارد کنید. نسخه شما باید قبل از یک کلمه رایج که Google معمولاً قبل از شناسایی نتایج جستجو آن را کنار میگذارد، از |
مثال ها | ورودی کاربر: Star Wars Episode +I عبارت جستجو: q=Star+Wars+Episode+ %2BI |
فقط پیوندها جستجو، همه اصطلاحات [ allinlinks: ] | |
---|---|
شرح | عبارت اگر عبارت جستجوی شما شامل نسخه URL-Escape شده |
مثال ها | ورودی کاربر: allinlinks: Google search عبارت جستجو: q= allinlinks%3A+Google+search |
جستجوی عبارت | |
---|---|
شرح | عبارت جستجوی عبارت (") به شما امکان می دهد عبارات کامل را با قرار دادن عبارات در علامت نقل قول یا با اتصال آنها با خط فاصله جستجو کنید. نسخه بدون URL اگر به دنبال نقل قولهای معروف یا نامهای مناسب هستید، جستجوی عبارت بهویژه مفید است. همچنین می توانید از پارامتر درخواست as_epq برای ارسال جستجوی عبارت استفاده کنید. |
مثال ها | ورودی کاربر: "Abraham Lincoln" عبارت پرس و جو: q= %22Abraham+Lincoln%22 |
جستجوی فقط متن، همه اصطلاحات [allintext:] | |
---|---|
شرح | عبارت اگر عبارت جستجوی شما شامل عبارت نسخه URL-Escape شده |
مثال ها | این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در متن تمام اسناد موجود در نتایج جستجو ظاهر شوند: ورودی کاربر: allintext:Google search عبارت پرس و جو: q=allintext%3AGoogle+search |
جستجوی عنوان، عبارت واحد [intitle:] | |
---|---|
شرح | عبارت توجه: شما می توانید بیش از یک کلمه را که باید در عنوان سند گنجانده شود، با قرار دادن عبارت نسخه URL-Escape شده |
مثال ها | این مثال مشخص می کند که کلمه "Google" باید در عنوان هر سندی در نتایج جستجو ظاهر شود و کلمه "جستجو" باید در هر جایی از عنوان ها، URL ها، پیوندها یا متن اصلی آن اسناد ظاهر شود: |
جستجوی عنوان، همه اصطلاحات [allintitle:] | |
---|---|
شرح | نکته: قرار دادن نسخه URL-Escape شده |
مثال ها | این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در عنوان هر سندی در نتایج جستجو ظاهر شود: |
جستجوی URL، عبارت واحد [inurl:] | |
---|---|
شرح | عبارت عبارت نسخه URL-Escape شده |
مثال ها | این مثال مشخص می کند که کلمه "Google" باید در URL های هر سندی در نتایج جستجو ظاهر شود و کلمه "جستجو" باید در هر جایی از عنوان، URL ها، پیوندها یا متن اصلی آن اسناد ظاهر شود: |
جستجوی URL، همه اصطلاحات [allinurl:] | |
---|---|
شرح | عبارت عبارت نسخه URL-Escape شده |
مثال ها | این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در URL هر سندی در نتایج جستجو ظاهر شوند: |
اطلاعات سند وب [اطلاعات:] | |
---|---|
شرح | نسخه URL-Escape شده توجه: هنگام استفاده از |
مثال ها | ورودی کاربر: info:www.google.com عبارت جستجو: q= info%3Awww.google.com |
نمونه پرس و جوهای تصویری
مثالهای زیر چند درخواست تصویر HTTP را نشان میدهند تا نحوه استفاده از پارامترهای پرس و جوی مختلف را نشان دهند. تعاریف پارامترهای مختلف پرس و جو در بخش تعاریف پارامتر کوئری تصویر این سند ارائه شده است.
این درخواست 5 نتیجه اول ( 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 |
imgtype | |
---|---|
شرح | اختیاری . تصاویری از یک نوع را برمی گرداند که می تواند یکی از موارد زیر باشد:
|
مثال ها | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
شرح | اختیاری . تصاویر سیاه و سفید، خاکستری یا رنگی را برمیگرداند:
|
مثال ها | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
شرح | اختیاری . تصاویر یک رنگ غالب خاص را برمی گرداند:
|
مثال ها | q=google&as_filetype=png&imgcolor=yellow |
به عنوان_حقوق | |
---|---|
شرح | اختیاری . فیلتر بر اساس مجوز. مقادیر پشتیبانی شده عبارتند از:
|
مثال ها | q=cats&as_filetype=png&as_rights=cc_attribute |
محدودیت های درخواست
نمودار زیر محدودیتهای درخواستهای جستجویی را که به Google ارسال میکنید فهرست میکند:
جزء | حد | اظهار نظر |
---|---|---|
طول درخواست جستجو | 2048 بایت | |
تعداد اصطلاحات پرس و جو | 10 | شامل اصطلاحات در پارامترهای زیر است: q , as_epq , as_eq , as_lq , as_oq , as_q |
تعداد نتایج | 20 | اگر پارامتر num را روی عددی بزرگتر از 20 قرار دهید، تنها 20 نتیجه برگردانده می شود. برای به دست آوردن نتایج بیشتر، باید چندین درخواست ارسال کنید و مقدار پارامتر شروع را با هر درخواست افزایش دهید. |
بین المللی کردن پرس و جوها و ارائه نتایج
سرویس Google WebSearch به شما امکان می دهد اسناد را به چندین زبان جستجو کنید. شما می توانید رمزگذاری کاراکتری را که باید برای تفسیر درخواست HTTP و رمزگذاری پاسخ XML خود (با استفاده از پارامترهای جستجوی ie و oe ) استفاده شود، مشخص کنید. همچنین میتوانید نتایج را فیلتر کنید تا فقط اسناد نوشته شده به زبانهای خاصی را شامل شود.
بخش های زیر مسائل مربوط به جستجو در چند زبان را مورد بحث قرار می دهد:
رمزگذاری کاراکتر
سرورها داده هایی مانند صفحات وب را به عنوان دنباله ای از بایت های کدگذاری شده به عوامل کاربر مانند مرورگرها ارسال می کنند. سپس عامل کاربر بایت ها را به دنباله ای از کاراکترها رمزگشایی می کند. هنگام ارسال درخواستها به سرویس جستجوی وب، میتوانید طرحهای رمزگذاری را هم برای درخواست جستجوی خود و هم برای پاسخ XML که دریافت میکنید مشخص کنید.
می توانید از پارامتر ie request برای تعیین مکانیسم رمزگذاری برای کاراکترهای درخواست HTTP خود استفاده کنید. همچنین می توانید از پارامتر oe برای تعیین طرح رمزگذاری که Google باید برای رمزگذاری پاسخ 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 را به صراحت در نتایج جستجو تنظیم کنید تا اطمینان حاصل شود که Google بالاترین کیفیت جستجوی نتایج را برای هر پرس و جو انتخاب می کند.
لطفاً برای لیست کاملی از مقادیر معتبر برای پارامتر HL ، به بخش زبان رابط پشتیبانی شده مراجعه کنید.
در جستجوی اسنادی که به زبانهای خاص نوشته شده اند
می توانید از پارامتر درخواست LR برای محدود کردن نتایج جستجو به اسنادی که به یک زبان خاص یا مجموعه زبانها نوشته شده اند استفاده کنید.
پارامتر LR از اپراتورهای بولی پشتیبانی می کند تا به شما امکان می دهد چندین زبان را مشخص کنید که باید از نتایج جستجو گنجانده شود.
مثالهای زیر نشان می دهد که چگونه ممکن است از اپراتورهای بولی برای درخواست اسناد به زبانهای مختلف استفاده کنید.
برای اسنادی که به زبان ژاپنی نوشته شده است:
lr=lang_jp
برای اسنادی که به زبان ایتالیایی یا آلمانی نوشته شده است:
lr=lang_it|lang_de
برای اسنادی که به زبان مجارستانی یا چک نوشته نشده است:
lr=(-lang_hu).(-lang_cs)
لطفاً برای یک لیست کامل از مقادیر ممکن برای پارامتر LR و بخش اپراتورهای Boolean برای بحث کامل در مورد استفاده از این اپراتورها ، به بخش مقادیر مجموعه زبان مراجعه کنید.
جستجوی ساده و سنتی چینی
چینی ساده و چینی دو نوع نوشتن از زبان چینی هستند. همان مفهوم ممکن است در هر نوع متفاوت نوشته شود. با توجه به پرس و جو در یکی از انواع ، سرویس Google WebSearch می تواند نتایج را که شامل صفحات در هر دو نوع است ، بازگرداند.
برای استفاده از این ویژگی:
- پارامتر درخواست C2COFF را روی 0 تنظیم کنید
و - یکی از موارد زیر را انجام دهید:
مثال زیر پارامترهای پرس و جو را در درخواست نتایج در هر دو چینی ساده و سنتی درج می کنید. (توجه داشته باشید که اطلاعات مورد نیاز اضافی ، مانند مشتری ، در مثال گنجانده نشده است.)
search?hl=zh-CN &lr=lang_zh-TW|lang_zh-CN &c2coff=0
فیلتر کردن نتایج
Google WebSearch چندین روش برای فیلتر کردن نتایج جستجوی شما ارائه می دهد:
فیلتر خودکار نتایج جستجو
در تلاش برای ارائه بهترین نتایج جستجو ممکن ، Google از دو تکنیک برای فیلتر کردن نتایج جستجوی خودکار استفاده می کند که عموماً نامطلوب تلقی می شوند:
محتوای تکراری - اگر اسناد متعدد حاوی همان اطلاعات هستند ، پس از آن فقط مرتبط ترین سند آن مجموعه در نتایج جستجوی شما گنجانده شده است.
جمعیت میزبان - اگر نتایج جستجوی زیادی از همان سایت وجود دارد ، گوگل ممکن است تمام نتایج حاصل از آن سایت را نشان ندهد یا ممکن است نتایج را در پایین تر نشان دهد
رتبه بندی از آنچه در غیر این صورت بود.
توصیه می کنیم این فیلترها را برای درخواست های جستجوی معمولی بگذارید زیرا فیلترها به طور قابل توجهی کیفیت بیشتر نتایج جستجو را افزایش می دهند. با این حال ، می توانید با تنظیم پارامتر پرس و جو فیلتر روی 0 در درخواست جستجوی خود ، این فیلترهای اتوماتیک را دور بزنید.
فیلتر زبان و کشور
سرویس Google WebSearch نتایج حاصل از فهرست اصلی همه اسناد وب را برمی گرداند. شاخص اصلی شامل زیر مجموعه اسناد است که توسط ویژگی های خاص از جمله زبان و کشور مبدا گروه بندی می شوند.
شما می توانید از پارامترهای درخواست LR و CR استفاده کنید تا نتایج جستجو را به زیر مجموعه اسنادی که به زبان های خاص نوشته شده اند محدود کنید یا به ترتیب از کشورهای خاص سرچشمه بگیرید.
Google WebSearch با تجزیه و تحلیل: زبان یک سند را تعیین می کند:
- دامنه سطح بالا (TLD) URL سند
- برچسب های متا زبان در سند
- زبان اصلی مورد استفاده در متن بدن سند
لطفاً تعریف پارامتر LR ، بخش جستجوی اسناد نوشته شده به زبان های خاص و مقادیر جمع آوری زبان را مشاهده کنید که می تواند به عنوان مقادیر پارامتر LR برای اطلاعات بیشتر در مورد محدود کردن نتایج بر اساس زبان استفاده شود.
Google WebSearch کشور یک سند را با تجزیه و تحلیل تعیین می کند:
- دامنه سطح بالا (TLD) URL سند
- موقعیت جغرافیایی آدرس IP سرور وب
لطفاً برای اطلاعات بیشتر در مورد محدود کردن نتایج توسط کشور مبدا ، تعریف پارامتر CR و مقادیر مجموعه کشور را که می تواند به عنوان مقادیر پارامتر CR استفاده شود ، ببینید.
توجه: شما می توانید مقادیر زبان و مقادیر کشور را برای سفارشی کردن نتایج جستجوی خود ترکیب کنید. به عنوان مثال ، شما می توانید اسنادی را که به زبان فرانسه نوشته شده و از فرانسه یا کانادا آمده است درخواست کنید ، یا می توانید اسنادی را که از هلند آمده و به زبان انگلیسی نوشته نشده است درخواست کنید. پارامترهای LR و CR هر دو از اپراتورهای بولی پشتیبانی می کنند.
فیلتر کردن محتوای بزرگسالان با SafeSearch
بسیاری از مشتریان Google نمی خواهند نتایج جستجو را برای سایتهایی که حاوی محتوای بزرگسالان هستند ، نمایش دهند. با استفاده از فیلتر SafeSearch ما ، می توانید نتایج جستجو را که حاوی محتوای بزرگسالان است ، نمایش داده و آنها را از بین ببرید. فیلترهای Google از فناوری اختصاصی برای بررسی کلمات کلیدی ، عبارات و URL استفاده می کنند. در حالی که هیچ فیلتر 100 درصد دقیق نیست ، SafeSearch اکثریت قریب به اتفاق محتوای بزرگسالان را از نتایج جستجوی شما حذف می کند.
Google در تلاش است تا با خزیدن مداوم در وب و با درج کردن به روزرسانی های پیشنهادات کاربر ، امنیت امن را تا حد امکان فعلی و جامع نگه دارد.
SafeSearch به زبانهای زیر در دسترس است:
هلندی انگلیسی فرانسوی آلمانی | ایتالیایی پرتغالی (برزیلی) اسپانیایی چینی سنتی |
شما می توانید با استفاده از پارامتر Safe Query ، درجه ای که Google نتایج خود را برای محتوای بزرگسالان فیلتر می کند ، تنظیم کنید. در جدول زیر تنظیمات SafeSearch Google و چگونگی تأثیر آن تنظیمات بر نتایج جستجوی شما توضیح داده شده است:
سطح ایمن | شرح |
---|---|
بالا | یک نسخه دقیق تر از جستجوی ایمن را فعال می کند. |
متوسط | صفحات وب حاوی مستهجن و سایر محتوای جنسی صریح را مسدود می کند. |
خاموش | محتوای بزرگسالان را از نتایج جستجو فیلتر نمی کند. |
* تنظیم پیش فرض SafeSearch خاموش است.
اگر SafeSearch را فعال کرده اید و سایت هایی را پیدا می کنید که حاوی محتوای توهین آمیز در نتایج شما هستند ، لطفاً URL سایت را به safesearch@google.com از طریق ایمیل ارسال کنید ، و ما سایت را بررسی خواهیم کرد.
نتایج XML
- Google XML نتایج DTD
- در مورد پاسخ XML
- نتایج XML برای نمایش داده های جستجوی منظم و پیشرفته
- جستجوی منظم/پیشرفته: نمونه پرس و جو و نتیجه XML
- جستجوی منظم/پیشرفته: برچسب های XML
Google XML نتایج DTD
Google از همان DTD برای توصیف قالب XML برای انواع نتایج جستجو استفاده می کند. بسیاری از برچسب ها و ویژگی ها برای انواع جستجو قابل استفاده است. با این حال ، برخی از برچسب ها فقط برای انواع جستجوی خاص قابل استفاده هستند. در نتیجه ، تعاریف موجود در DTD ممکن است محدود کننده تر از تعاریف ذکر شده در این سند باشد.
این سند جنبه های DTD را که برای WebSearch مرتبط هستند ، توصیف می کند. وقتی به DTD نگاه می کنید ، اگر در WebSearch کار می کنید ، می توانید با اطمینان از برچسب ها و ویژگی هایی که در اینجا ثبت نشده اند ، نادیده بگیرید. اگر تعریف بین DTD و مستندات متفاوت باشد ، این واقعیت در این سند ذکر شده است.
Google می تواند نتایج XML را با یا بدون مراجعه به جدیدترین DTD بازگرداند. DTD راهنمایی برای کمک به مدیران جستجو و پارسرهای XML است که نتایج XML Google را درک می کنند. از آنجا که گرامر XML Google ممکن است هر از گاهی تغییر کند ، شما نباید تجزیه کننده خود را پیکربندی کنید تا از DTD برای تأیید هر نتیجه XML استفاده کنید.
علاوه بر این ، شما نباید تجزیه و تحلیل XML خود را پیکربندی کنید تا هر بار که درخواست جستجو را ارسال کنید ، DTD را واکشی کنید. Google DTD را به ندرت به روز می کند ، و این درخواست ها تأخیر غیر ضروری و نیازهای پهنای باند را ایجاد می کنند.
Google توصیه می کند که برای دریافت نتایج XML از فرمت خروجی XML_NO_DTD استفاده کنید. اگر قالب خروجی XML را در درخواست جستجوی خود مشخص کنید ، تنها تفاوت در گنجاندن خط زیر در نتایج XML است:
<!DOCTYPE GSP SYSTEM "google.dtd">
می توانید به آخرین DTD در http://www.google.com/google.dtd دسترسی پیدا کنید.
لطفاً توجه داشته باشید که همه ویژگی های موجود در DTD ممکن است در این زمان در دسترس یا پشتیبانی شوند.
در مورد پاسخ XML
- تمام مقادیر عنصر معتبر HTML مناسب برای نمایش هستند مگر اینکه در تعاریف برچسب XML ذکر شده باشد.
- برخی از مقادیر عنصر URL هایی هستند که قبل از نمایش آنها باید رمزگذاری شوند.
- تجزیه کننده XML شما باید ویژگی ها و برچسب های بدون مدارک را نادیده بگیرد. اگر Google ویژگی های بیشتری را به خروجی XML اضافه کند ، این امکان را به شما می دهد تا بدون تغییر کار خود را ادامه دهد.
- شخصیت های خاصی باید در هنگام قرار گرفتن به عنوان مقادیر در برچسب های XML ، فرار شوند. پردازنده XML شما باید این موجودات را به شخصیت های مناسب تبدیل کند. اگر نهادها را به درستی تبدیل نکنید ، مرورگر ممکن است به عنوان مثال ، شخصیت را به عنوان "& amp ؛" ارائه دهد. استاندارد XML این شخصیت ها را مستند می کند. این شخصیت ها در جدول زیر بازتولید می شوند:
شخصیت فرم های فراری وجود، موجودیت رمز شخصیت ampersand & & & ؛ نقل قول واحد ' & apos ؛ ' ؛ نقل قول مضاعف " " " ؛ بزرگتر از > > > ؛ کمتر از < &آن؛ < ؛
نتایج XML برای نمایش داده های جستجوی منظم و پیشرفته
جستجوی منظم/پیشرفته: نمونه پرس و جو و نتیجه XML
این درخواست WebSearch نمونه 10 نتیجه ( num=10
) در مورد اصطلاح جستجو "Socer" ( q=socer
) ، که کلمه "فوتبال" است که عمداً برای این مثال اشتباه اشتباه است.)
http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i
این درخواست نتیجه XML را در زیر به دست می آورد. توجه داشته باشید که چندین نظر در نتیجه XML وجود دارد تا نشان دهد که برچسب های خاصی در نتیجه در نتیجه ظاهر نمی شوند.
<?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>
جستجوی منظم/پیشرفته: برچسب های XML
پاسخ های XML برای درخواست های جستجوی منظم و درخواست های جستجوی پیشرفته هر دو از مجموعه ای از برچسب های XML استفاده می کنند. این برچسب های XML در مثال XML در بالا نشان داده شده و در جداول زیر توضیح داده شده است.
برچسب های XML در زیر به صورت الفبایی با نام برچسب ذکر شده است ، و هر تعریف برچسب شامل توضیحی از برچسب است ، مثالی نشان می دهد که چگونه برچسب در یک نتیجه XML و قالب محتوای برچسب ظاهر می شود. اگر این برچسب زیر مجموعه ای از برچسب XML دیگر باشد یا اگر برچسب دارای زیرمجموعه یا ویژگی های خاص خود باشد ، آن اطلاعات در جدول تعریف برچسب نیز ارائه می شود.
برخی از نمادها ممکن است در کنار برخی از زیرگروه ها در تعاریف زیر نمایش داده شوند. این نمادها و معانی آنها عبارتند از:
* = صفر یا بیشتر نمونه های فرعی
+ = یک یا چند نمونه از زیرمجموعه
آ | ب | سی | دی | اف | جی | اچ | من | L | م | ن | پ | س | آر | اس | تی | U | ایکس |
anchor_text | |
---|---|
تعریف | برچسب <anchor_text> متنی را که باید به کاربران نمایش دهید تا برچسب پالایش مرتبط با یک مجموعه نتیجه جستجو را شناسایی کنید. از آنجا که برچسب های پالایش ، کاراکترهای غیر alphanumeric را با زیربناها جایگزین می کنند ، نباید مقدار برچسب <label> را در رابط کاربری خود نمایش دهید. در عوض ، شما باید مقدار برچسب <lanchor_text> را نمایش دهید. |
مثال | <anchor_text> زمین های گلف </anchor_text> |
زیر مجموعه از | قضیه |
قالب محتوا | متن |
مسدود کردن | |
---|---|
تعریف | این برچسب محتویات یک بلوک را در یک خط بدنه از یک نتیجه ارتقاء محاصره می کند. هر بلوک دارای زیرمجموعه های t ، u و l است. یک برچسب t غیر خالی نشان می دهد که بلوک حاوی متن است. برچسب های U و L غیر خالی نشان می دهد که این بلوک حاوی پیوندی است (با URL در متن u subtag و anchor در زیر مجموعه L ). |
زیرگروه | T ، U ، L |
زیر مجموعه از | بدنه |
قالب محتوا | خالی |
بدنه | |
---|---|
تعریف | این برچسب محتویات یک خط در بدنه نتیجه ترویج را محاصره می کند. هر خط بدن از چندین برچسب بلوک تشکیل شده است که یا حاوی برخی از متن یا پیوندی با URL و متن لنگر است. |
زیرگروه | مسدود کردن * |
زیر مجموعه از | sl_main |
قالب محتوا | خالی |
سی | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
تعریف | برچسب <c> نشان می دهد که سرویس WebSearch می تواند یک نسخه ذخیره شده از این URL نتیجه جستجو را بازیابی کند. شما نمی توانید صفحات ذخیره شده را از طریق API XML بازیابی کنید ، اما می توانید کاربران را برای این محتوا به www.google.com هدایت کنید. | |||||||||
ویژگی های |
| |||||||||
مثال | <c sz = "6k" cid = "kvoxk_cyssgj" /> | |||||||||
زیر مجموعه از | دارد | |||||||||
قالب محتوا | خالی |
C2C | |
---|---|
تعریف | برچسب <c2c> نشان می دهد که نتیجه به یک صفحه سنتی زبان چینی اشاره دارد. این برچسب فقط در صورت فعال بودن و جستجوی سنتی چینی ظاهر می شود. برای کسب اطلاعات بیشتر در مورد فعال کردن و غیرفعال کردن این ویژگی ، به تعریف پارامتر C2COFF مراجعه کنید. |
قالب محتوا | متن |
متن نوشته | |
---|---|
تعریف | برچسب <Sttenction> لیستی از برچسب های پالایش مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد. |
مثال | <Context> |
زیرگروه | عنوان ، جنبه + |
قالب محتوا | ظرف |
خزنده | |
---|---|
تعریف | برچسب <crawldate> تاریخی را که آخرین صفحه خزش شده است مشخص می کند. |
مثال | <Crawldate> 21 مه 2005 </crawldate> |
زیر مجموعه از | آر |
قالب محتوا | متن |
DI | |
---|---|
تعریف | برچسب <di> اطلاعات دسته ای از پروژه دایرکتوری باز (ODP) را برای یک نتیجه جستجوی واحد محصور می کند. |
مثال | <di> |
زیرگروه | dt ؟ ، ds ؟ |
زیر مجموعه از | دارد |
قالب محتوا | خالی |
DS | |
---|---|
تعریف | برچسب <ds> خلاصه ذکر شده برای یک دسته واحد در فهرست ODP را ارائه می دهد. |
مثال | <ds> خود را ارسال کنید & lt ؛ b & gt ؛ soccer & lt ؛/b & gt ؛ به طور مستقیم در اینترنت از سر بگیرید. </ds> |
زیر مجموعه از | DI |
قالب محتوا | متن (ممکن است حاوی HTML باشد) |
DT | |
---|---|
تعریف | برچسب <dt> عنوان را برای یک دسته واحد ذکر شده در فهرست ODP ارائه می دهد. |
مثال | <Dt> soccerconnection.net </st> |
زیر مجموعه از | DI |
قالب محتوا | متن (ممکن است حاوی HTML باشد) |
جنبه | |
---|---|
تعریف | برچسب <SaceT> شامل یک گروه بندی منطقی از برچسب های <SaceTitem> است. شما می توانید این گروه ها را با استفاده از فرمت مشخصات موتور جستجوگر موتور جستجوگر XML ایجاد کنید. اگر این گروه بندی ها را ایجاد نکنید ، برچسب نتایج_xml_tag_context> <pontect> شامل چهار برچسب <SaceT> خواهد بود. موارد موجود در هر برچسب <SaceT> برای اهداف نمایش گروه بندی می شوند اما ممکن است رابطه منطقی نداشته باشند. |
مثال | <SaceT> |
زیرگروه | FACETITEM +، عنوان + |
زیر مجموعه از | متن نوشته |
قالب محتوا | ظرف |
قضیه | |
---|---|
تعریف | برچسب <SacateTitem> اطلاعات مربوط به برچسب پالایش مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد. |
مثال | <SaceTitem> |
زیرگروه | برچسب ، anchor_text + |
زیر مجموعه از | جنبه |
قالب محتوا | قضیه |
FI | |
---|---|
تعریف | برچسب <fi> به عنوان پرچمی عمل می کند که نشان می دهد آیا فیلتر اسناد برای جستجو انجام شده است یا خیر. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی Google ، به بخش فیلتر خودکار این سند مراجعه کنید. |
مثال | <فی /> |
زیر مجموعه از | RES |
قالب محتوا | خالی |
GSP | |||||||
---|---|---|---|---|---|---|---|
تعریف | برچسب <GSP> تمام داده های برگشتی در نتایج جستجوی Google XML را محصور می کند. "GSP" مخفف "پروتکل جستجوی Google" است. | ||||||
ویژگی های |
| ||||||
مثال | <gsp ver = "3.2"> | ||||||
زیرگروه | param +، q ، res ؟ ، tm | ||||||
قالب محتوا | خالی |
دارد | |
---|---|
تعریف | برچسب <sas> اطلاعات مربوط به هر پارامترهای درخواست ویژه جستجوی را که برای یک URL خاص پشتیبانی می شود ، محصور می کند. توجه: تعریف <sas> برای WebSearch محدودتر از DTD است. |
زیرگروه | di ؟ ، l ؟ ، c ؟ ، rt ؟ |
زیر مجموعه از | آر |
ایزورل | |
---|---|
تعریف | در صورت پرس و جو جستجوی مرتبط URL ، Google برچسب <SISURL> را برمی گرداند. |
زیر مجموعه از | GSP |
قالب محتوا | خالی |
L | |
---|---|
تعریف | حضور برچسب <l> نشان می دهد که سرویس WebSearch می تواند سایتهای دیگری را پیدا کند که به این آدرس جستجو نتیجه می روند. برای یافتن چنین سایتهایی ، از لینک استفاده می کنید: اصطلاح پرس و جو ویژه. |
زیر مجموعه از | دارد |
قالب محتوا | خالی |
برچسب | |
---|---|
تعریف | برچسب <label> یک برچسب پالایش را مشخص می کند که می توانید برای فیلتر کردن نتایج جستجو که دریافت می کنید استفاده کنید. برای استفاده از برچسب پالایش ، رشته را بیشتر اضافه کنید: [[مقدار برچسب برچسب]] به مقدار پارامتر Q در درخواست HTTP خود به Google همانطور که در مثال زیر نشان داده شده است. لطفاً توجه داشته باشید که این مقدار قبل از ارسال پرس و جو به Google باید URL باشد. This example uses the refinement label golf_courses to توجه: برچسب <label> همان برچسب <label> نیست ، که یک برچسب پالایش مرتبط با یک URL خاص در نتایج جستجوی شما را مشخص می کند. |
مثال | <label> golf_courses </loge> |
زیر مجموعه از | قضیه |
قالب محتوا | متن |
LANG | |
---|---|
تعریف | برچسب <lang> حاوی بهترین حدس گوگل از زبان نتیجه جستجو است. |
مثال | <lang> en </lang> |
زیر مجموعه از | آر |
قالب محتوا | متن |
م | |
---|---|
تعریف | برچسب <m> تعداد کل نتایج برای جستجو را مشخص می کند. توجه: این برآورد ممکن است دقیق نباشد. |
مثال | <m> 16200000 </m> |
زیر مجموعه از | RES |
قالب محتوا | متن |
NB | |
---|---|
تعریف | برچسب <nb> اطلاعات ناوبری را به صفحه بعدی نتایج جستجو یا صفحه قبلی نتایج جستجو - برای مجموعه نتیجه می دهد. توجه: این برچسب فقط در صورت وجود نتایج بیشتر موجود است. |
مثال | <nb> |
زیرگروه | nu ؟ ، pu ؟ |
زیر مجموعه از | RES |
قالب محتوا | خالی |
NU | |
---|---|
تعریف | برچسب <nu> حاوی پیوند نسبی به صفحه بعدی نتایج جستجو است. |
مثال | <nu>/جستجو؟ q = گلها و num = 10 & hl = en & ie = utf-8 & output = xml & client = test & start = 10 </nu> |
زیر مجموعه از | NB |
قالب محتوا | متن (URL نسبی) |
پارتی | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
تعریف | برچسب <param> یک پارامتر ورودی ارسال شده در درخواست HTTP مرتبط با نتیجه XML را مشخص می کند. اطلاعات مربوط به پارامتر در ویژگی های برچسب - نام ، مقدار ، Original_Value - موجود است و برای هر پارامتر ارسال شده در درخواست HTTP یک برچسب پارام وجود خواهد داشت. | ||||||||||||
ویژگی های |
| ||||||||||||
مثال | <param name = "cr" value = "countrynz" original_value = "countryNz" /> | ||||||||||||
زیر مجموعه از | GSP | ||||||||||||
قالب محتوا | مجتمع |
PU | |
---|---|
تعریف | برچسب <PU> یک پیوند نسبی به صفحه قبلی نتایج جستجو ارائه می دهد. |
مثال | <pu>/جستجو؟ q = گلها و num = 10 & hl = en & output = xml & client = test & start = 10 </u> |
زیر مجموعه از | NB |
قالب محتوا | متن (URL نسبی) |
س | |
---|---|
تعریف | برچسب <Q> پرس و جو جستجوی ارائه شده در درخواست HTTP مرتبط با نتیجه XML را مشخص می کند. |
مثال | <Q> پیتزا </q> |
زیر مجموعه از | GSP |
قالب محتوا | متن |
آر | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
تعریف | برچسب <R> جزئیات نتیجه جستجوی فردی را در بر می گیرد. توجه: تعریف برچسب <R> برای WebSearch محدودتر از DTD است. | |||||||||
ویژگی های |
| |||||||||
زیرگروه | U ، Ue ، T ؟ ، Crawldate ، S ؟ ، Lang ؟ ، | |||||||||
زیر مجموعه از | RES |
RES | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
تعریف | برچسب <SES> مجموعه ای از نتایج جستجوی فردی و جزئیات مربوط به آن نتایج را محاصره می کند. | |||||||||
ویژگی های |
| |||||||||
مثال | <res sn = "1" en = "10"> | |||||||||
زیرگروه | m ، fi ؟ ، xt ؟ ، nb ؟ ، r * | |||||||||
زیر مجموعه از | GSP | |||||||||
قالب محتوا | خالی |
اس | |
---|---|
تعریف | برچسب <S> حاوی گزیده ای برای نتیجه جستجو است که اصطلاحات پرس و جو را به صورت جسورانه نشان می دهد. استراحت خط در گزیده ای برای بسته بندی مناسب متن درج شده است. |
مثال | <S> واشنگتن (CNN) - پیشنهاد برای پایان دادن به وضعیت سنا نسبت به رئیس جمهور & lt ؛ b & gt ؛ bush ' ؛ s & lt ؛/b & gt ؛ انتخاب های قضایی به پنج نامزد اجازه می دهد تا ضمن حفظ & lt ؛ b & gt ؛ ... & lt ؛ b & gt ؛ ... & lt ؛/b & gt ؛ <s> به رأی نهایی برسند. |
زیر مجموعه از | آر |
قالب محتوا | متن (HTML) |
sl_main | |
---|---|
تعریف | این برچسب محتوای یک نتیجه تبلیغاتی را در بر می گیرد. برای تبلیغات تجزیه و تحلیل استفاده کنید. متن لنگر و URL پیوند عنوان به ترتیب در زیرگروه های T و U موجود است. خطوط متن و پیوندها در زیر مجموعه های Body_line موجود است. |
زیرگروه | body_line *، t ، u |
زیر مجموعه از | sl_results |
قالب محتوا | خالی |
sl_results | |
---|---|
تعریف | برچسب کانتینر برای نتایج ارتقا یافته. یکی از این موارد هر زمان که در نتایج جستجوی خود تبلیغی داشته باشید ظاهر می شود. SL_MAIN SUBTAG شامل داده های نتیجه اصلی است. |
زیرگروه | sl_main * |
زیر مجموعه از | آر |
قالب محتوا | خالی |
املا | |
---|---|
تعریف | برچسب <sypling> یک پیشنهاد املایی متناوب را برای پرس و جو ارسال شده درج می کند. این برچسب فقط در صفحه اول نتایج جستجو ظاهر می شود. پیشنهادات املایی به زبان انگلیسی ، چینی ، ژاپنی و کره ای در دسترس است. توجه: Google فقط پیشنهادات املایی را برای پرس و جو در جایی که مقدار پارامتر GL در حروف کوچک است ، برمی گرداند. |
مثال | <املایی> |
زیرگروه | پیشنهاد |
زیر مجموعه از | GSP |
قالب محتوا | خالی |
پیشنهاد | |||||||
---|---|---|---|---|---|---|---|
تعریف | برچسب <Drovidention> حاوی یک پیشنهاد املایی متناوب برای پرس و جو ارسال شده است. می توانید از محتوای TAG استفاده کنید تا املای متناوب را به کاربر جستجوی خود پیشنهاد دهید. مقدار ویژگی Q پیشنهاد املایی URL است که می توانید به عنوان یک اصطلاح پرس و جو از آن استفاده کنید. | ||||||
ویژگی های |
| ||||||
مثال | <پیشنهاد q = "فوتبال"> & lt ؛ b & gt ؛ & lt ؛ i & gt ؛ soccer & lt ؛/i & gt ؛ & lt ؛/b & gt ؛ | ||||||
زیر مجموعه از | املا | ||||||
قالب محتوا | متن (HTML) |
تی | |
---|---|
تعریف | برچسب <t> شامل عنوان نتیجه است. |
مثال | <t> پیتزا فروشی ساحل شرقی Amici </t> |
زیر مجموعه از | آر |
قالب محتوا | متن (HTML) |
عنوان | |
---|---|
تعریف | به عنوان یک کودک <Context> ، برچسب <TION> حاوی نام موتور جستجوی قابل برنامه ریزی شما است. به عنوان یک کودک <SaceT> ، برچسب <TITE> عنوانی را برای مجموعه ای از جنبه ها فراهم می کند. |
مثال | به عنوان یک کودک <Context>: <TITE> موتور جستجوی من </title> به عنوان یک کودک <SaceT>: <TITE> عنوان FACET </TION> |
زیر مجموعه از | متن ، جنبه |
قالب محتوا | متن |
TM | |
---|---|
تعریف | برچسب <tm> کل زمان سرور مورد نیاز برای بازگشت نتایج جستجو ، اندازه گیری شده در ثانیه را مشخص می کند. |
مثال | <Tm> 0.100445 </tm> |
زیر مجموعه از | GSP |
قالب محتوا | متن (شماره نقطه شناور) |
TT | |
---|---|
تعریف | برچسب <tt> نکته جستجو را ارائه می دهد. |
مثال | <tt> & lt ؛ i & gt ؛ نکته: برای اکثر مرورگرها ، فشار دادن کلید بازگشت همان نتایج را با کلیک بر روی دکمه جستجو تولید می کند. & lt ؛/i & gt ؛ </tt> |
زیر مجموعه از | GSP |
U | |
---|---|
تعریف | برچسب <u> URL نتیجه جستجو را ارائه می دهد. |
مثال | <u> http://www.dominos.com/ </u> |
زیر مجموعه از | آر |
قالب محتوا | متن (URL مطلق) |
UD | |
---|---|
تعریف | برچسب <UD> URL IDN رمزگذاری شده (نام دامنه بین المللی) را برای نتیجه جستجو فراهم می کند. این مقدار اجازه می دهد دامنه ها با استفاده از زبانهای محلی نمایش داده شوند. به عنوان مثال ، url idn-encoded http: //www.٪E8٪8A٪B1٪E4٪BA٪95.com می تواند رمزگشایی و به عنوان http: // www. 花井 鮨 .com نمایش داده شود. این برچسب <UD> فقط در نتایج جستجو برای درخواست هایی که شامل پارامتر UD است ، گنجانده می شود. توجه: این یک ویژگی بتا است. |
مثال | <ud> http: //www.٪E8٪8A٪B1٪E4٪BA٪95.com/ </ud> |
زیر مجموعه از | آر |
قالب محتوا | متن (URL رمزگذاری شده IDN) |
اوی | |
---|---|
تعریف | برچسب <ue> URL نتیجه جستجو را ارائه می دهد. این مقدار URL به گونه ای است که برای عبور به عنوان یک پارامتر پرس و جو در یک URL مناسب است. |
مثال | <ue> http://www.dominos.com/ </ue> |
زیر مجموعه از | آر |
قالب محتوا | متن (URL URL-EXPED) |
XT | |
---|---|
تعریف | برچسب <tt> نشان می دهد که تعداد کل نتایج تخمین زده شده ، همانطور که توسط برچسب M مشخص شده است ، در واقع تعداد دقیق نتایج را نشان می دهد. برای اطلاعات بیشتر به بخش فیلتر خودکار این سند مراجعه کنید. |
مثال | <xt /> |
زیر مجموعه از | RES |
قالب محتوا | خالی |
نتایج XML برای نمایش داده های جستجوی تصویر
این درخواست تصویر نمونه 5 نتیجه (شماره = 5) در مورد اصطلاح جستجو "میمون" (q = میمون) می خواهد.
http://www.google.com/cse? searchtype=image &num=2 &q=monkey &client=google-csbe &output=xml_no_dtd &cx=00255077836266642015:u-scht7a-8i
این درخواست نتیجه XML را در زیر به دست می آورد.
<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>
جستجوی تصویر: برچسب های XML
جدول زیر برچسب های XML اضافی مورد استفاده در پاسخ های XML برای نمایش داده های جستجوی تصویر را نشان می دهد.
برخی از نمادها ممکن است در کنار برخی از زیرگروه ها در تعاریف زیر نمایش داده شوند. این نمادها و معانی آنها عبارتند از:
* = صفر یا بیشتر نمونه های فرعی
+ = یک یا چند نمونه از زیرمجموعه
RG | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
تعریف | برچسب <Rg> جزئیات نتیجه جستجوی تصویر فردی را در خود جای می دهد. | |||||||||
ویژگی های |
| |||||||||
زیر مجموعه از | RES |
RU | |
---|---|
تعریف | برچسب <Ru Tag> جزئیات هر نتیجه جستجوی تصویر را محصور می کند. |
زیر مجموعه از | آر |