مرجع XML API

این صفحه به نسخه XML جستجوی سفارشی JSON API اشاره دارد که فقط برای مشتریان جستجوی سایت Google در دسترس است.

  1. نمای کلی
  2. فرمت درخواست موتور جستجو قابل برنامه ریزی
    1. درخواست بررسی اجمالی
    2. شرایط پرس و جو
    3. پارامترهای درخواست
      1. نمونه پرس و جوهای جستجوی وب
      2. تعاریف پارامترهای جستجوی وب
      3. جستجوی پیشرفته
      4. پارامترهای جستجوی پیشرفته
      5. شرایط درخواست ویژه
      6. نمونه پرس و جوهای تصویری
      7. پارامترهای جستجوی تصویر
      8. محدودیت های درخواست
    4. بین المللی کردن پرس و جوها و ارائه نتایج
      1. رمزگذاری کاراکتر
      2. زبان های رابط
      3. جستجوی ساده و سنتی چینی
    5. فیلتر کردن نتایج
      1. فیلتر کردن خودکار نتایج جستجو
      2. فیلتر زبان و کشور
      3. فیلتر کردن محتوای بزرگسالان با جستجوی ایمن
  3. نتایج XML
    1. نتایج Google XML DTD
    2. درباره پاسخ XML
    3. نتایج XML برای عبارت‌های جستجوی معمولی، تصویری و پیشرفته
      1. جستجوی منظم/پیشرفته: پرس و جو نمونه و نتیجه XML
      2. جستجوی منظم/پیشرفته: برچسب های XML
      3. نتایج XML برای پرس و جوهای جستجوی تصویر
      4. جستجوی تصویر: نمونه پرس و جو و نتیجه XML
      5. جستجوی تصویر: برچسب های 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 که نشان دهنده شناسه منحصر به فرد موتور است.

متداول ترین پارامترهای درخواستی غیر از موارد ذکر شده در بالا عبارتند از:

  • num - تعداد درخواستی نتایج جستجو
  • q - عبارت(های) جستجو
  • start -شاخص شروع نتایج

نمونه پرس و جوهای جستجوی وب

مثال‌های زیر چند درخواست 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 ویژگی جستجوی ساده و سنتی چینی را فعال یا غیرفعال می کند.

مقدار پیش فرض این پارامتر 0 (صفر) است، به این معنی که ویژگی فعال است. مقادیر پارامتر c2coff عبارتند از:

ارزش اقدام
1 از کار افتاده است
0 فعال شد
نمونه ها q=google&c2coff=1
مشتری
توضیحات

مورد نیاز . پارامتر client باید روی google-csbe تنظیم شود.

نمونه ها q=google&client=google-csbe
cr
توضیحات

اختیاری پارامتر cr نتایج جستجو را محدود به اسنادی می‌کند که از یک کشور خاص سرچشمه می‌گیرند. می توانید از عملگرهای بولی در مقدار پارامتر cr استفاده کنید.

Google WebSearch کشور یک سند را با تجزیه و تحلیل:

  • دامنه سطح بالای (TLD) URL سند
  • موقعیت جغرافیایی آدرس IP سرور وب

برای فهرستی از مقادیر معتبر برای این پارامتر، بخش مقادیر پارامتر کشور (cr) را ببینید.

نمونه ها q=Frodo&cr=countryNZ
cx
توضیحات

مورد نیاز . پارامتر cx یک کد منحصر به فرد را مشخص می کند که یک موتور جستجوی سفارشی را شناسایی می کند. شما باید یک موتور جستجوی قابل برنامه ریزی را با استفاده از پارامتر cx برای بازیابی نتایج جستجو از آن موتور مشخص کنید.

برای یافتن مقدار پارامتر cx ، به Control Panel > Tab Codes موتور خود بروید و آن را در قسمت متن زیر «Paste this code» در صفحه‌ای که می‌خواهید کادر جستجوی شما ظاهر شود، پیدا خواهید کرد. نتایج جستجو در یک صفحه میزبان گوگل نشان داده خواهد شد.'

نمونه ها q=Frodo&cx=00255077836266642015:u-scht7a-8i
فیلتر
توضیحات

اختیاری پارامتر فیلتر فیلتر کردن خودکار نتایج جستجوی گوگل را فعال یا غیرفعال می کند. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی Google، بخش فیلترینگ خودکار این سند را ببینید.

مقدار پیش‌فرض پارامتر filter 1 است که نشان می‌دهد این ویژگی فعال است. مقادیر معتبر برای این پارامتر عبارتند از:

ارزش اقدام
1 از کار افتاده است
0 فعال شد

توجه: به‌طور پیش‌فرض، گوگل برای بهبود کیفیت آن نتایج، فیلتر را برای همه نتایج جستجو اعمال می‌کند.

نمونه ها q=google&filter=0
gl
توضیحات

اختیاری مقدار پارامتر gl یک کد کشور دو حرفی است. برای نتایج جستجوی وب، پارامتر gl نتایج جستجویی را که کشور مبدا با مقدار پارامتر مطابقت دارد، افزایش می‌دهد. برای لیستی از مقادیر معتبر به بخش کدهای کشور مراجعه کنید.

تعیین مقدار پارامتر gl در درخواست‌های WebSearch باید ارتباط نتایج را بهبود بخشد. این امر به ویژه برای مشتریان بین المللی و حتی به طور خاص برای مشتریان در کشورهای انگلیسی زبان به جز ایالات متحده صادق است.

نمونه ها

این درخواست اسناد نوشته شده در بریتانیا را در نتایج جستجوی وب تقویت می کند:
q=pizza&gl=uk
hl
توضیحات

اختیاری پارامتر hl زبان رابط (زبان میزبان) رابط کاربری شما را مشخص می کند. برای بهبود عملکرد و کیفیت نتایج جستجوی خود، قویاً توصیه می شود این پارامتر را به صراحت تنظیم کنید.

برای اطلاعات بیشتر به بخش زبان‌های رابط بین‌المللی کردن پرسش‌ها و ارائه نتایج و زبان‌های رابط پشتیبانی‌شده برای فهرستی از زبان‌های پشتیبانی‌شده مراجعه کنید.

نمونه ها

این درخواست تبلیغات برای شراب به زبان فرانسوی را هدف قرار می دهد. ( وین اصطلاح فرانسوی برای شراب است.)

q=vin&ip=10.10.10.10&ad=w5& hl=fr

hq
توضیحات

اختیاری پارامتر hq اصطلاحات پرس و جوی مشخص شده را به پرس و جو اضافه می کند، گویی که با یک عملگر AND منطقی ترکیب شده اند.

نمونه ها

این درخواست عبارت "پیتزا" و "پنیر" را جستجو می کند. عبارت همان q=pizza+cheese است.

q=pizza&hq=cheese


یعنی
توضیحات

اختیاری پارامتر ie طرح رمزگذاری کاراکتر را تنظیم می کند که باید برای تفسیر رشته پرس و جو استفاده شود. مقدار پیش فرض ie latin1 است.

برای بحث در مورد زمانی که ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش رمزگذاری کاراکتر مراجعه کنید.

برای لیست ie ممکن، به بخش Character Encoding Schemes مراجعه کنید.

نمونه ها q=google&ie=utf8&oe=utf8
lr
توضیحات

اختیاری پارامتر lr (محدودیت زبان) نتایج جستجو را به اسناد نوشته شده به یک زبان خاص محدود می کند.

Google WebSearch زبان یک سند را با تجزیه و تحلیل زیر تعیین می کند:

  • دامنه سطح بالای (TLD) URL سند
  • متا تگ های زبان در سند
  • زبان اصلی مورد استفاده در متن متن سند
  • زبان های ثانویه، در صورت وجود، در متن اصلی سند استفاده شده است

برای لیستی از مقادیر معتبر برای این پارامتر به بخش Language ( lr ) Collection Values ​​مراجعه کنید.

نمونه ها q=Frodo&lr=lang_en
تعداد
توضیحات

اختیاری پارامتر num تعداد نتایج جستجو را برای بازگشت مشخص می کند.

مقدار پیش فرض num 10 و حداکثر مقدار 20 است. در صورت درخواست بیش از 20 نتیجه، تنها 20 نتیجه برگردانده می شود.

توجه: اگر تعداد کل نتایج جستجو کمتر از تعداد نتایج درخواستی باشد، همه نتایج جستجوی موجود برگردانده می شوند.

نمونه ها q=google& num=10
oe
توضیحات

اختیاری پارامتر oe طرح رمزگذاری کاراکتر را تنظیم می کند که باید برای رمزگشایی نتیجه XML استفاده شود. مقدار oe پیش فرض latin1 است.

برای بحث در مورد زمانی که ممکن است نیاز به استفاده از این پارامتر داشته باشید، به بخش رمزگذاری کاراکتر مراجعه کنید.

برای لیست مقادیر oe ممکن به بخش Character Encoding Schemes مراجعه کنید.

نمونه ها q=google&ie=utf8& oe=utf8
خروجی
توضیحات

مورد نیاز . پارامتر output فرمت نتایج XML را مشخص می کند. تنها مقادیر معتبر برای این پارامتر xml و xml_no_dtd هستند. نمودار زیر چگونگی تفاوت این مقادیر پارامتر را توضیح می دهد.

ارزش فرمت خروجی
xml_no_dtd نتایج XML شامل یک عبارت !DOCTYPE نخواهد بود. (توصیه می شود)
xml نتایج XML حاوی یک مرجع Google DTD خواهد بود. خط دوم نتیجه، نوع تعریف سند (DTD) را که نتایج از آن استفاده می‌کنند، مشخص می‌کند: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
نمونه ها output=xml_no_dtd
output=xml

q
توضیحات

اختیاری پارامتر q کوئری جستجوی وارد شده توسط کاربر را مشخص می کند. حتی اگر این پارامتر اختیاری است، شما باید مقداری را برای حداقل یکی از پارامترهای پرس و جو ( as_epq ، as_lq ، as_oq ، as_q تعیین کنید تا نتایج جستجو را دریافت کنید.

همچنین تعدادی عبارت پرس و جو ویژه وجود دارد که می تواند به عنوان بخشی از مقدار پارامتر q استفاده شود. لطفاً برای فهرست و تعاریف این اصطلاحات به شرایط پرس و جو ویژه مراجعه کنید.

کنترل پنل جستجوی Google شامل گزارشی از درخواست های برتر ارسال شده با استفاده از پارامتر q است.

توجه: مقدار مشخص شده برای پارامتر q باید URL-escape شده باشد.

نمونه ها q=vacation &as_oq=london+paris

امن
توضیحات

اختیاری پارامتر safe نشان می دهد که چگونه نتایج جستجو برای محتوای بزرگسالان و محتوای مستهجن فیلتر شود. مقدار پیش‌فرض پارامتر safe off است. مقادیر پارامترهای معتبر عبارتند از:

ارزش اقدام
off جستجوی ایمن را غیرفعال کنید
medium SafeSearch را فعال کنید
high یک نسخه سخت گیرانه از SafeSearch را فعال کنید

برای جزئیات بیشتر در مورد این ویژگی به بخش فیلتر کردن محتوای بزرگسالان با جستجوی ایمن مراجعه کنید.

نمونه ها q=adult&safe=high
شروع کنید
توضیحات

اختیاری پارامتر start نشان دهنده اولین نتیجه تطبیقی ​​است که باید در نتایج جستجو گنجانده شود. پارامتر start از یک شاخص مبتنی بر صفر استفاده می کند، به این معنی که اولین نتیجه 0، نتیجه دوم 1 و غیره است.

پارامتر start در ارتباط با پارامتر num کار می کند تا مشخص کند کدام نتایج جستجو را بازگرداند. توجه داشته باشید که برای هر پرس و جو بیش از 1000 نتیجه برگردانده نمی شود، حتی اگر بیش از 1000 سند با پرس و جو مطابقت داشته باشند، بنابراین تنظیم شروع به 1000 یا بیشتر هیچ نتیجه ای ایجاد نمی کند.

نمونه ها start=10

مرتب کردن
توضیحات

اختیاری پارامتر sort مشخص می کند که نتایج بر اساس عبارت مشخص شده مرتب شوند. به عنوان مثال، مرتب سازی بر اساس تاریخ.

نمونه ها

sort=date


ud
توضیحات

اختیاری پارامتر ud نشان می دهد که آیا پاسخ XML باید URL کدگذاری شده با IDN را برای نتیجه جستجو شامل شود یا خیر. رمزگذاری IDN (نام دامنه بین المللی) به دامنه ها اجازه می دهد تا با استفاده از زبان های محلی نمایش داده شوند، به عنوان مثال:

http://www.花井鮨.com

مقادیر معتبر برای این پارامتر 1 (پیش‌فرض) است، به این معنی که نتیجه XML باید شامل URL‌های کدگذاری‌شده با IDN باشد، و 0 ، به این معنی که نتیجه XML نباید شامل URL‌های کدگذاری‌شده با IDN باشد. اگر پارامتر ud روی 1 تنظیم شود، URL کدگذاری شده با IDN در تگ UD در نتایج XML شما ظاهر می شود.

اگر پارامتر ud روی 0 تنظیم شود، URL در مثال بالا به صورت زیر نمایش داده می شود:

http://www.xn--elq438j.com.

توجه: این یک ویژگی بتا است.

نمونه ها q=google&ud=1

پارامترهای پرس و جو اضافی که در زیر تصویر فهرست شده اند، مربوط به جستارهای جستجوی پیشرفته هستند. هنگامی که یک جستجوی پیشرفته را ارسال می کنید، مقادیر چندین پارامتر (مانند as_eq ، as_epq ، as_oq ، و غیره) همه در عبارت جستجو برای آن جستجو لحاظ می شوند. تصویر صفحه جستجوی پیشرفته گوگل را نشان می دهد. روی تصویر، نام هر پارامتر جستجوی پیشرفته با متن قرمز در داخل یا در کنار فیلد صفحه ای که آن پارامتر با آن مطابقت دارد، نوشته شده است.



پارامترهای جستجوی پیشرفته

as_dt
توضیحات

اختیاری پارامتر as_dt کنترل می کند که آیا نتایج از سایتی که در پارامتر as_sitesearch نامگذاری شده است را شامل شود یا حذف کند. مقادیر i و e به ترتیب نشان دهنده گنجاندن و حذف هستند.

نمونه ها as_dt=i,as_dt=e

as_epq
توضیحات

اختیاری پارامتر as_epq عبارتی را مشخص می کند که تمام اسناد در نتایج جستجو باید حاوی آن باشند. همچنین می توانید از عبارت عبارت جستجوی عبارت جستجو برای جستجوی یک عبارت استفاده کنید.

نمونه ها as_epq=abraham+lincoln
as_eq
توضیحات

اختیاری پارامتر as_eq کلمه یا عبارتی را مشخص می کند که نباید در هیچ سندی در نتایج جستجو ظاهر شود. همچنین می توانید از عبارت exclude query استفاده کنید تا اطمینان حاصل کنید که یک کلمه یا عبارت خاص در اسناد در مجموعه ای از نتایج جستجو ظاهر نمی شود.

نمونه ها

q=bass&as_eq=music .


as_lq
توضیحات

اختیاری پارامتر as_lq مشخص می کند که تمام نتایج جستجو باید حاوی پیوندی به یک URL خاص باشند. همچنین می توانید از پیوند: عبارت query برای این نوع پرس و جو استفاده کنید.

نمونه ها

as_lq=www.google.com


as_nlo
توضیحات

اختیاری پارامتر as_nlo مقدار شروع را برای محدوده جستجو مشخص می کند. از as_nlo و as_nhi برای افزودن محدوده جستجوی فراگیر as_nlo...as_nhi به پرس و جو استفاده کنید.

نمونه ها

موارد زیر محدوده جستجوی 5 تا 10 را شامل می‌شود:

as_nlo=5&as_nhi=10

as_nhi
توضیحات

اختیاری پارامتر as_nhi مقدار پایانی یک محدوده جستجو را مشخص می کند. از as_nlo و as_nhi برای افزودن محدوده جستجوی فراگیر as_nlo...as_nhi به پرس و جو استفاده کنید.

نمونه ها

موارد زیر محدوده جستجوی 5 تا 10 را شامل می‌شود:

as_nlo=5&as_nhi=10

as_oq
توضیحات

اختیاری پارامتر as_oq عبارت‌های جستجوی اضافی را برای بررسی در یک سند فراهم می‌کند، جایی که هر سند در نتایج جستجو باید حداقل یکی از عبارت‌های جستجوی اضافی را داشته باشد. همچنین می توانید از عبارت Boolean OR برای این نوع پرس و جو استفاده کنید.

نمونه ها

q=vacation&as_oq=London+Paris
as_q
توضیحات

اختیاری پارامتر as_q عبارات جستجو را برای بررسی در یک سند فراهم می کند. این پارامتر همچنین معمولاً برای اجازه دادن به کاربران برای تعیین عبارات اضافی برای جستجو در مجموعه ای از نتایج جستجو استفاده می شود.

نمونه ها

q=president&as_q=John+Adams


as_qdr
توضیحات

اختیاری پارامتر as_qdr نتایج جستجو را از یک دوره زمانی مشخص (محدوده تاریخ سریع) درخواست می کند. مقادیر زیر پشتیبانی می شوند:

d[number] درخواست‌ها از تعداد مشخص شده روزهای گذشته نتیجه می‌شوند.
درخواست‌های w[number] از تعداد مشخص شده هفته‌های گذشته نتیجه می‌گیرد.
m[number] درخواست‌ها از تعداد مشخص شده ماه‌های گذشته نتیجه می‌گیرند.
y[number] درخواست‌ها از تعداد مشخص شده سال‌های گذشته نتیجه می‌گیرد.

نمونه ها

این مثال نتایج سال گذشته را درخواست می کند:

as_qdr=y

این نمونه درخواست نتایج مربوط به 10 روز گذشته:

as_qdr=d10

as_sitesearch
توضیحات

اختیاری پارامتر as_sitesearch به شما اجازه می دهد تا مشخص کنید که تمام نتایج جستجو باید صفحاتی از یک سایت خاص باشند. با تنظیم پارامتر as_dt ، می توانید از آن برای حذف صفحات یک سایت خاص از نتایج جستجوی خود نیز استفاده کنید.

نمونه ها

q=vacation&as_sitesearch=www.google.com


شرایط درخواست ویژه

جستجوی وب گوگل امکان استفاده از چندین عبارت جستجوی خاص را می دهد که به قابلیت های اضافی موتور جستجوی گوگل دسترسی دارد. این عبارات پرس و جوی خاص باید در مقدار پارامتر درخواست q گنجانده شوند. مانند سایر اصطلاحات پرس و جو، اصطلاحات پرس و جوی خاص باید دارای URL-escape شوند. تعدادی از اصطلاحات پرس و جوی خاص حاوی دو نقطه (:) هستند. این کاراکتر همچنین باید دارای URL-escape باشد. مقدار URL آن %3A است.

پیوندهای برگشتی [لینک:]
توضیحات

link: عبارت query مجموعه ای از صفحات وب را بازیابی می کند که به یک URL خاص پیوند دارند. عبارت جستجو باید به صورت link:URL بدون فاصله بین link: عبارت جستجو و URL قالب بندی شود.

نسخه URL-Escape شده link: link%3A است.

همچنین می توانید از پارامتر درخواست as_lq برای ارسال یک link: درخواست.

توجه: هنگام استفاده از link: .

نمونه ها

http://www.google.com/search? q=link%3Awww.example.com
جستجوی بولی یا بولی [OR]
توضیحات

عبارت OR پرس و جو اسنادی را بازیابی می کند که شامل یکی از یک سری (دو یا چند) عبارت پرس و جو است. برای استفاده از عبارت جستجوی OR ، عبارت جستجوی 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 ( - ) نتایج یک درخواست جستجوی خاص را به اسنادی که حاوی کلمه یا عبارت خاصی نیستند محدود می کند. برای استفاده از عبارت عبارت query exclude، باید کلمه یا عبارتی را که از اسناد منطبق حذف می شود با "-" (یک علامت منفی) مقدمه کنید.

نسخه بدون URL - %2D است.

عبارت exclude query زمانی مفید است که یک عبارت جستجو بیش از یک معنی داشته باشد. به عنوان مثال، کلمه "باس" می تواند نتایجی را در مورد ماهی یا موسیقی ارائه دهد. اگر به دنبال اسنادی درباره ماهی بودید، می‌توانید با استفاده از عبارت جستجوی حذف، اسناد مربوط به موسیقی را از نتایج جستجو حذف کنید.

همچنین می توانید از پارامتر درخواست as_eq برای حذف اسناد منطبق با یک کلمه یا عبارت خاص از نتایج جستجو استفاده کنید.

نمونه ها ورودی کاربر: bass -music
عبارت جستجو: q=bass+ %2Dmusic
حذف نوع فایل [ -filetype: ]
توضیحات

عبارت پرس و جو -filetype: اسنادی با پسوند فایل خاص، مانند ".pdf" یا ".doc" را از نتایج جستجو مستثنی می کند. عبارت جستجو باید به صورت -filetype:EXTENSION بدون فاصله بین عبارت -filetype: query و پسوند مشخص شده قالب بندی شود.

نسخه URL-escape -filetype: %2Dfiletype%3A است.

توجه: می‌توانید چندین نوع فایل را با افزودن عبارت‌های جستجوی -filetype: بیشتر از نتایج جستجو حذف کنید. برای هر پسوند فایل باید یک عبارت پرس و جو -filetype: داشته باشید که باید از نتایج جستجو حذف شود.

انواع فایل های پشتیبانی شده توسط گوگل عبارتند از:

  • فرمت سند قابل حمل Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • مک رایت (mw)
  • مایکروسافت اکسل (xls)
  • پاورپوینت مایکروسافت (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks، wps، wdb)
  • مایکروسافت رایت (wri)
  • فرمت متن غنی (rtf)
  • Shockwave Flash (swf)
  • متن (ans, txt).

ممکن است در آینده انواع فایل های اضافی اضافه شود. یک لیست به‌روز را می‌توانید همیشه در سؤالات متداول نوع فایل Google پیدا کنید.

نمونه ها

این مثال اسنادی را برمی‌گرداند که «Google» را ذکر کرده‌اند اما اسناد PDF نیستند:
q=Google+ %2Dfiletype%3Apdf

این مثال اسنادی را برمی‌گرداند که «Google» را ذکر کرده‌اند، اما اسناد PDF و Word را حذف می‌کنند:
q=Google+ %2Dfiletype%3Apdf+%2Dfiletype%3Adoc
نوع فایل فیلتر کردن [نوع فایل: ]
توضیحات

filetype: عبارت پرس و جو نتایج جستجو را به اسنادی با پسوند فایل خاص، مانند ".pdf" یا ".doc" محدود می کند. عبارت جستجو باید به صورت filetype:EXTENSION بدون فاصله بین filetype: و پسوند مشخص شده قالب بندی شود.

نسخه URL-Escape از filetype: filetype%3A است.

می‌توانید نتایج جستجو را به اسنادی محدود کنید که با یکی از چندین پسوند فایل مطابقت دارند، با افزودن عبارت‌های جستجوی filetype: به درخواست خود. شما باید یک filetype: عبارت پرس و جو در عبارت جستجوی خود برای هر پسوند فایل که باید در نتایج جستجو گنجانده شود. filetype: اصطلاحات پرس و جو باید با استفاده از عبارت پرس و جو OR از هم جدا شوند.

به طور پیش فرض، نتایج جستجو شامل اسنادی با هر پسوند فایلی می شود.

انواع فایل های پشتیبانی شده توسط گوگل عبارتند از:

  • فرمت سند قابل حمل Adobe (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • مک رایت (mw)
  • مایکروسافت اکسل (xls)
  • پاورپوینت مایکروسافت (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks، wps، wdb)
  • مایکروسافت رایت (wri)
  • فرمت متن غنی (rtf)
  • Shockwave Flash (swf)
  • متن (ans, txt).

ممکن است در آینده انواع فایل های اضافی اضافه شود. یک لیست به‌روز را می‌توانید همیشه در سؤالات متداول نوع فایل Google پیدا کنید.

نمونه ها

این مثال اسناد PDF را که "Google" را ذکر کرده اند برمی گرداند:
q=Google+ filetype%3Apdf

این مثال اسناد PDF و Word را که "Google" را ذکر کرده اند، برمی گرداند:
q=Google+ filetype%3Apdf+OR+filetype%3Adoc
شامل عبارت پرس و جو [+]
توضیحات

عبارت پرس و جو شامل (+) مشخص می کند که یک کلمه یا عبارت باید در تمام اسناد موجود در نتایج جستجو وجود داشته باشد. برای استفاده از عبارت عبارت include query، باید کلمه یا عبارتی را که باید در همه نتایج جستجو گنجانده شود، با "+" (یک علامت مثبت) وارد کنید.

نسخه + (یک علامت بعلاوه) از URL خارج شده %2B است.

شما باید قبل از یک کلمه رایج که Google معمولاً قبل از شناسایی نتایج جستجو آن را کنار می‌گذارد، + استفاده کنید.

نمونه ها ورودی کاربر: Star Wars Episode +I
عبارت جستجو: q=Star+Wars+Episode+ %2BI
فقط پیوندها جستجو، همه اصطلاحات [ allinlinks: ]
توضیحات

عبارت allinlinks: عبارت پرس و جو مستلزم آن است که اسناد در نتایج جستجو حاوی تمام کلمات موجود در عبارت جستجو در پیوندهای URL باشد. عبارت جستجو باید به صورت allinlinks: به دنبال آن کلمات در عبارت جستجوی شما.

اگر عبارت جستجوی شما شامل allinlinks: عبارت query باشد، Google فقط پیوندهای URL موجود در اسناد را برای کلمات موجود در عبارت جستجوی شما بررسی می کند، بدون توجه به سایر متن ها در اسناد، عنوان سند و URL های هر سند. توجه داشته باشید که URL سند با پیوندهای URL موجود در سند متفاوت است.

نسخه URL-Escape شده allinlinks: allinlinks%3A است.

نمونه ها ورودی کاربر: allinlinks: Google search
عبارت جستجو: q= allinlinks%3A+Google+search
جستجوی عبارت
توضیحات

عبارت جستجوی عبارت (") به شما امکان می دهد عبارات کامل را با قرار دادن عبارات در علامت نقل قول یا با اتصال آنها با خط فاصله جستجو کنید.

نسخه بدون URL " (یک علامت نقل قول) %22 است.

اگر به دنبال نقل قول های معروف یا نام های مناسب هستید، جستجوی عبارت به ویژه مفید است.

همچنین می توانید از پارامتر درخواست as_epq برای ارسال جستجوی عبارت استفاده کنید.

نمونه ها ورودی کاربر: "Abraham Lincoln"
عبارت پرس و جو: q= %22Abraham+Lincoln%22
جستجوی فقط متن، همه اصطلاحات [allintext:]
توضیحات

عبارت allintext: query مستلزم آن است که هر سند در نتایج جستجو حاوی تمام کلمات جستجوی جستجو در بدنه سند باشد. پرس و جو باید به صورت allintext: به دنبال آن کلمات در عبارت جستجوی شما.

اگر عبارت جستجوی شما شامل عبارت allintext: query باشد، Google فقط متن اصلی اسناد را برای کلمات موجود در عبارت جستجوی شما بررسی می‌کند و پیوندهای موجود در آن اسناد، عنوان اسناد و URL اسناد را نادیده می‌گیرد.

نسخه URL-Escape شده allintext: allintext%3A است.

نمونه ها این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در متن تمام اسناد موجود در نتایج جستجو ظاهر شوند:
ورودی کاربر: allintext:Google search
عبارت پرس و جو: q=allintext%3AGoogle+search
جستجوی عنوان، عبارت واحد [intitle:]
توضیحات

عبارت intitle: query نتایج جستجو را به اسنادی که حاوی کلمه خاصی در عنوان سند هستند محدود می کند. عبارت جستجو باید به عنوان عنوان: WORD بدون فاصله بین عبارت intitle: query و کلمه زیر قالب بندی شود.

توجه: شما می توانید بیش از یک کلمه را که باید در عنوان سند گنجانده شود، با قرار دادن عبارت intitle: query در مقابل هر یک از این کلمات تعیین کنید. همچنین می توانید از عبارت allintitle: query استفاده کنید تا مشخص کنید که تمام کلمات پرس و جو باید در عنوان اسنادی که در نتایج جستجو هستند گنجانده شوند.

نسخه URL-Escape شده intitle: intitle%3A است.

نمونه ها

این مثال مشخص می کند که کلمه "Google" باید در عنوان هر سندی در نتایج جستجو ظاهر شود و کلمه "جستجو" باید در هر جایی از عنوان ها، URL ها، پیوندها یا متن اصلی آن اسناد ظاهر شود:
ورودی کاربر: intitle:Google search
عبارت جستجو: q= intitle%3AGoogle+search
جستجوی عنوان، همه اصطلاحات [allintitle:]
توضیحات

عبارت allintitle: عبارت پرس و جو نتایج جستجو را به اسنادی محدود می کند که حاوی همه کلمات پرس و جو در عنوان سند هستند. برای استفاده از عبارت allintitle: query، "allintitle:" را در ابتدای عبارت جستجوی خود قرار دهید.

نکته: قرار دادن allintitle: در ابتدای یک عبارت جستجو معادل قرار دادن intitle: در مقابل هر کلمه در عبارت جستجو است.

نسخه URL-Escape شده allintitle: allintitle%3A است.

نمونه ها

این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در عنوان هر سندی در نتایج جستجو ظاهر شود:
ورودی کاربر: allintitle: Google search
عبارت جستجو: q= allintitle%3A+Google+search
جستجوی URL، عبارت واحد [inurl:]
توضیحات

عبارت inurl: query نتایج جستجو را به اسنادی که حاوی کلمه خاصی در URL سند هستند محدود می کند. عبارت جستجو باید به صورت inurl:WORD بدون فاصله بین inurl: عبارت query و کلمه زیر قالب بندی شود.

عبارت inurl: query علائم نگارشی را نادیده می گیرد و فقط از اولین کلمه بعد از عملگر inurl: استفاده می کند. شما می توانید بیش از یک کلمه را که باید در URL سند گنجانده شود، با قرار دادن inurl: query در مقابل هر کلمه مشخص کنید. همچنین می‌توانید از عبارت allinurl: query استفاده کنید تا مشخص کنید همه کلمات پرس و جو باید در URL اسنادی که در نتایج جستجو هستند گنجانده شوند.

نسخه URL-Escape شده inurl: inurl%3A است.

نمونه ها

این مثال مشخص می کند که کلمه "Google" باید در URL های هر سندی در نتایج جستجو ظاهر شود و کلمه "جستجو" باید در هر جایی از عنوان ها، URL ها، پیوندها یا متن اصلی آن اسناد ظاهر شود:
ورودی کاربر: inurl:Google search
عبارت پرس و جو: q= inurl%3AGoogle+search
جستجوی URL، همه اصطلاحات [allinurl:]
توضیحات

عبارت allinurl: عبارت پرس و جو نتایج جستجو را به اسنادی محدود می کند که حاوی همه کلمات پرس و جو در URL سند هستند. برای استفاده از عبارت allinurl: query، allinurl: را در ابتدای عبارت جستجوی خود قرار دهید.

عبارت allinurl: query علائم نقطه گذاری را نادیده می گیرد، بنابراین فقط روی کلمات کار می کند، نه بر روی اجزای URL. به عنوان مثال، allinurl: uk/scotland نتایج را به اسنادی محدود می کند که حاوی کلمات "uk" و "scotland" در URL های خود هستند، اما نیازی به این ندارد که این دو کلمه به ترتیب خاصی ظاهر شوند یا با یک اسلش از هم جدا شوند.

نسخه URL-Escape شده allinurl: allinurl%3A است.

نمونه ها

این مثال مشخص می کند که کلمات "Google" و "جستجو" باید در URL هر سندی در نتایج جستجو ظاهر شود:
ورودی کاربر: allinurl: Google search
عبارت جستجو: q= allinurl%3A+Google+search



اطلاعات سند وب [اطلاعات:]
توضیحات

info: عبارت پرس و جو اطلاعات کلی در مورد یک URL را تا زمانی که آن URL در فهرست جستجوی Google گنجانده شده باشد، بازیابی می کند. عبارت جستجو باید به صورت info:URL بدون فاصله بین info: query و URL قالب بندی شود.

نسخه URL-Escape info: info%3A است.

توجه: هنگام استفاده از info: .

نمونه ها ورودی کاربر: 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
توضیحات

اختیاری تصاویری از نوع مشخص شده را برمی گرداند. مقادیر مجاز عبارتند از: bmp ، gif ، png ، jpg و svg .

نمونه ها q=google&as_filetype=png

imgsz
توضیحات

اختیاری تصاویری با اندازه مشخص را برمی‌گرداند که اندازه آن می‌تواند یکی از موارد زیر باشد:

  • icon (کوچک)
  • small|medium|large|xlarge (متوسط)
  • xxlarge (بزرگ)
  • huge (بسیار بزرگ)

نمونه ها q=google&as_filetype=png&imgsz=icon

imgtype
توضیحات

اختیاری تصاویری از یک نوع را برمی گرداند که می تواند یکی از موارد زیر باشد:

  • clipart (کلیپارت)
  • face (چهره)
  • lineart (خطی)
  • news (اخبار)
  • photo (عکس)

نمونه ها q=google&as_filetype=png&imgtype=photo

imgc
توضیحات

اختیاری تصاویر سیاه و سفید، خاکستری یا رنگی را برمی‌گرداند:

  • mono (سیاه و سفید)
  • gray (مقیاس خاکستری)
  • color (رنگ)

نمونه ها q=google&as_filetype=png&imgc=gray

imgcolor
توضیحات

اختیاری تصاویر یک رنگ غالب خاص را برمی گرداند:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
نمونه ها q=google&as_filetype=png&imgcolor=yellow

به عنوان_حقوق
توضیحات

اختیاری فیلتر بر اساس مجوز. مقادیر پشتیبانی شده عبارتند از:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

نمونه ها 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 می تواند نتایج را که شامل صفحات در هر دو نوع است ، بازگرداند.

برای استفاده از این قابلیت:

  1. پارامتر درخواست C2COFF را روی 0 تنظیم کنید
    و
  2. یکی از کارهای زیر را انجام دهید:
    • پارامتر درخواست LR را تنظیم نکنید
      یا
    • پارامتر درخواست LR را روی LR = LANG_ZH-TW | LANG_ZH-CN تنظیم کنید

مثال زیر پارامترهای پرس و جو را در درخواست نتایج در هر دو چینی ساده و سنتی درج می کنید. (توجه داشته باشید که اطلاعات مورد نیاز اضافی ، مانند مشتری ، در مثال گنجانده نشده است.)

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

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 این شخصیت ها را مستند می کند. این شخصیت ها در جدول زیر بازتولید می شوند:

    شخصیت فرم های فراری موجودیت کد کاراکتر
    آمپرسند & & amp ؛ &#38;
    نقل قول واحد ' &apos; &#39;
    دو نقل قول " &quot; &#34;
    بزرگتر از > &gt; &#62;
    کمتر از < &آن؛ &#60;

نتایج 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 دیگر باشد یا اگر برچسب دارای زیرمجموعه یا ویژگی های خاص خود باشد ، آن اطلاعات در جدول تعریف برچسب نیز ارائه می شود.

برخی از نمادها ممکن است در کنار برخی از زیرگروه ها در تعاریف زیر نمایش داده شوند. این نمادها و معانی آنها عبارتند از:

? = subtag اختیاری
* = صفر یا بیشتر نمونه های فرعی
+ = یک یا چند نمونه از زیرمجموعه
الف ب سی دی اف جی اچ من L م ن پ س آر اس تی U X

anchor_text
تعریف

برچسب <anchor_text> متنی را که باید به کاربران نمایش دهید تا برچسب پالایش مرتبط با یک مجموعه نتیجه جستجو را شناسایی کنید. از آنجا که برچسب های پالایش ، کاراکترهای غیر alphanumeric را با زیربناها جایگزین می کنند ، نباید مقدار برچسب <label> را در رابط کاربری خود نمایش دهید. در عوض ، شما باید مقدار برچسب <lanchor_text> را نمایش دهید.

مثال <anchor_text> زمین های گلف </anchor_text>
زیر مجموعه از قضیه
فرمت محتوا متن
BLOCK
تعریف

این برچسب محتویات یک بلوک را در یک خط بدنه از یک نتیجه ارتقاء محاصره می کند. هر بلوک دارای زیرمجموعه های 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 هدایت کنید.

صفات
نام قالب توضیحات
SZ متن (عدد صحیح + "k") اندازه نسخه ذخیره شده از نتیجه جستجو در کیلوبایت ("K") را فراهم می کند.
CID متن یک سند را در حافظه نهان گوگل مشخص می کند. برای واکشی سند از حافظه نهان ، یک اصطلاح جستجو را به شرح زیر ارسال کنید:
حافظه پنهان: cidtext : فرار

URL فراری در برچسب UE موجود است.

مثال <c sz = "6k" cid = "kvoxk_cyssgj" />
زیر مجموعه از دارد
فرمت محتوا خالی
C2C
تعریف برچسب <c2c> نشان می دهد که نتیجه به یک صفحه سنتی زبان چینی اشاره دارد. این برچسب فقط در صورت فعال بودن و جستجوی سنتی چینی ظاهر می شود. برای کسب اطلاعات بیشتر در مورد فعال کردن و غیرفعال کردن این ویژگی ، به تعریف پارامتر C2COFF مراجعه کنید.
فرمت محتوا متن
زمینه
تعریف

برچسب <Sttenction> لیستی از برچسب های پالایش مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد.

مثال <Context>
زیرگروه عنوان ، جنبه +
فرمت محتوا ظرف

خزنده
تعریف

برچسب <crawldate> تاریخی را که آخرین صفحه خزش شده است مشخص می کند. CRAWLDATE برای هر صفحه نتیجه جستجو بازگردانده نمی شود.

مثال <Crawldate> 21 مه 2005 </crawldate>
زیر مجموعه از آر
فرمت محتوا متن
دیزائی
تعریف

برچسب <di> اطلاعات دسته ای از پروژه دایرکتوری باز (ODP) را برای یک نتیجه جستجوی واحد محصور می کند.

مثال <di>
زیرگروه dt ؟ ، ds ؟
زیر مجموعه از دارد
فرمت محتوا خالی
DS
تعریف

برچسب <ds> خلاصه ذکر شده برای یک دسته واحد در فهرست ODP را ارائه می دهد.

مثال <ds> خود را ارسال کنید & lt ؛ b & gt ؛ soccer & lt ؛/b & gt ؛ به طور مستقیم در اینترنت از سر بگیرید. </ds>
زیر مجموعه از دیزائی
فرمت محتوا متن (ممکن است حاوی HTML باشد)
DT
تعریف

برچسب <dt> عنوان را برای یک دسته واحد ذکر شده در فهرست ODP ارائه می دهد.

مثال <Dt> soccerconnection.net </st>
زیر مجموعه از دیزائی
فرمت محتوا متن (ممکن است حاوی HTML باشد)
جنبه
تعریف

برچسب <SaceT> شامل یک گروه بندی منطقی از برچسب های <SaceTitem> است. شما می توانید این گروه ها را با استفاده از فرمت مشخصات موتور جستجوگر موتور جستجوگر XML ایجاد کنید. اگر این گروه بندی ها را ایجاد نکنید ، برچسب نتایج_xml_tag_context> <pontect> شامل چهار برچسب <SaceT> خواهد بود. موارد موجود در هر برچسب <SaceT> برای اهداف نمایش گروه بندی می شوند اما ممکن است رابطه منطقی نداشته باشند.

مثال <SaceT>
زیرگروه FACETITEM +، عنوان +
زیر مجموعه از زمینه
فرمت محتوا ظرف

قضیه
تعریف

برچسب <SacateTitem> اطلاعات مربوط به برچسب پالایش مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد.

مثال <SaceTitem>
زیرگروه برچسب ، anchor_text +
زیر مجموعه از جنبه
فرمت محتوا قضیه
فای
تعریف برچسب <fi> به عنوان پرچمی عمل می کند که نشان می دهد آیا فیلتر اسناد برای جستجو انجام شده است یا خیر. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی Google ، به بخش فیلتر خودکار این سند مراجعه کنید.
مثال <فی />
زیر مجموعه از RES
فرمت محتوا خالی
GSP
تعریف

برچسب <GSP> تمام داده های برگشتی در نتایج جستجوی Google XML را محصور می کند. "GSP" مخفف "پروتکل جستجوی Google" است.

صفات
نام قالب توضیحات
VER متن (عدد صحیح) ویژگی VER نسخه خروجی نتایج جستجو را مشخص می کند. نسخه خروجی فعلی "3.2" است.
مثال <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
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

توجه: برچسب <label> همان برچسب <label> نیست ، که یک برچسب پالایش مرتبط با یک URL خاص در نتایج جستجوی شما را مشخص می کند.

مثال <label> golf_courses </loge>
زیر مجموعه از قضیه
فرمت محتوا متن
لنگ
تعریف

برچسب <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
تعریف

برچسب <param> یک پارامتر ورودی ارسال شده در درخواست HTTP مرتبط با نتیجه XML را مشخص می کند. اطلاعات مربوط به پارامتر در ویژگی های TAG - نام ، مقدار ، Original_Value - موجود است و برای هر پارامتر ارسال شده در درخواست HTTP یک برچسب پارام وجود خواهد داشت.

صفات
نام قالب توضیحات
نام متن نام پارامتر ورودی.
ارزش HTML نسخه HTML با مقدار پارامتر ورودی.
مقادیر اصلی_ متن نسخه اصلی URL از مقدار پارامتر ورودی.
مثال <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 است.

صفات
نام قالب توضیحات
ن متن (عدد صحیح) شاخص (1 مبتنی بر) این نتیجه جستجو را نشان می دهد.
MIME متن نوع تقلید نتیجه جستجو را نشان می دهد.
زیرگروه U ، Ue ، T ؟ ، Crawldate ، S ؟ ، Lang ؟ ،
زیر مجموعه از RES
RES
تعریف

برچسب <SES> مجموعه ای از نتایج جستجوی فردی و جزئیات مربوط به آن نتایج را محاصره می کند.

صفات
نام قالب توضیحات
SN متن (عدد صحیح) شاخص (1 مبتنی بر) اولین نتیجه جستجو را در این مجموعه نتیجه نشان می دهد.
EN متن (عدد صحیح) شاخص (1 مبتنی بر) آخرین نتیجه جستجو را در این مجموعه نتیجه نشان می دهد.
مثال <res sn = "1" en = "10">
زیرگروه m ، fi ؟ ، xt ؟ ، nb ؟ ، r *
زیر مجموعه از GSP
فرمت محتوا خالی
اس
تعریف

برچسب <S> حاوی گزیده ای برای نتیجه جستجو است که اصطلاحات پرس و جو را به صورت جسورانه نشان می دهد. استراحت خط در گزیده ای برای بسته بندی مناسب متن درج شده است.

مثال <S> واشنگتن (CNN) - پیشنهاد برای پایان دادن به وضعیت سنا نسبت به رئیس جمهور & lt ؛ b & gt ؛ bush &#39 ؛ 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 متن ویژگی 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
تعریف برچسب <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 برای نمایش داده های جستجوی تصویر را نشان می دهد.

برخی از نمادها ممکن است در کنار برخی از زیرگروه ها در تعاریف زیر نمایش داده شوند. این نمادها و معانی آنها عبارتند از:

? = subtag اختیاری
* = صفر یا بیشتر نمونه های فرعی
+ = یک یا چند نمونه از زیرمجموعه

RG
تعریف

برچسب <Rg> جزئیات نتیجه جستجوی تصویر فردی را در خود جای می دهد.

صفات
نام قالب توضیحات
ن متن (عدد صحیح) شاخص (1 مبتنی بر) این نتیجه جستجو را نشان می دهد.
MIME متن نوع تقلید نتیجه جستجو را نشان می دهد.
زیر مجموعه از RES
RU
تعریف

برچسب <Ru Tag> جزئیات هر نتیجه جستجوی تصویر را محصور می کند.

زیر مجموعه از آر

 ،

این صفحه به نسخه XML از جستجوی سفارشی JSON API اشاره دارد که فقط برای مشتریان جستجوی سایت Google در دسترس است.

  1. نمای کلی
  2. فرمت درخواست موتور جستجو قابل برنامه ریزی
    1. بررسی اجمالی
    2. شرایط پرس و جو
    3. درخواست پارامترها
      1. نمونه نمایش داده های WebSearch
      2. تعاریف پارامتر پرس و جو WebSearch
      3. جستجوی پیشرفته
      4. پارامترهای پرس و جو جستجوی پیشرفته
      5. اصطلاحات خاص پرس و جو
      6. نمونه نمایش داده های تصویر
      7. پارامترهای جستجوی جستجوی تصویر
      8. محدودیت های درخواست
    4. بین المللی کردن نمایش داده ها و ارائه نتایج
      1. رمزگذاری شخصیت
      2. زبانهای رابط
      3. جستجوی ساده و سنتی چینی
    5. نتایج فیلتر
      1. فیلتر خودکار نتایج جستجو
      2. فیلتر زبان و کشور
      3. فیلتر کردن محتوای بزرگسالان با SafeSearch
  3. نتایج XML
    1. Google XML نتایج DTD
    2. در مورد پاسخ XML
    3. نتایج XML برای نمایش داده های منظم ، تصویر و پیشرفته جستجو
      1. جستجوی منظم/پیشرفته: نمونه پرس و جو و نتیجه XML
      2. جستجوی منظم/پیشرفته: برچسب های XML
      3. نتایج XML برای نمایش داده های جستجوی تصویر
      4. جستجوی تصویر: نمونه پرس و جو و نتیجه XML
      5. جستجوی تصویر: برچسب های XML

نمای کلی

سرویس Google WebSearch مشتریان جستجوی سایت Google را قادر می سازد تا نتایج جستجوی Google را در وب سایت های خود نمایش دهند. سرویس WebSearch از یک پروتکل ساده مبتنی بر HTTP برای ارائه نتایج جستجو استفاده می کند. مدیران جستجو کنترل کاملی بر نحوه درخواست نتایج جستجو و نحوه ارائه آن نتایج به کاربر نهایی دارند. این سند جزئیات فنی فرمت های درخواست و نتایج جستجوی Google را شرح می دهد.

برای بازیابی نتایج Google WebSearch ، برنامه شما یک درخواست HTTP ساده را به Google ارسال می کند. Google سپس نتایج جستجو را در قالب XML برمی گرداند. نتایج XML با فرمت به شما امکان سفارشی سازی نحوه نمایش نتایج جستجو را می دهد.

قالب درخواست WebSearch

بررسی اجمالی

درخواست Google Search یک دستور استاندارد HTTP GET است. این مجموعه شامل مجموعه ای از پارامترهای مربوط به نمایش داده های شما است. این پارامترها در URL درخواست به عنوان name = جفت ارزش جدا شده توسط کاراکترهای Ampersand (&) گنجانده شده است. پارامترها شامل داده هایی مانند جستجوی جستجو و شناسه موتور منحصر به فرد ( cx ) است که موتور را که درخواست HTTP را می کند ، مشخص می کند. سرویس جستجوی WebSearch یا تصویر نتایج XML را در پاسخ به درخواست های HTTP شما برمی گرداند.

شرایط پرس و جو

بیشتر درخواست های جستجو شامل یک یا چند اصطلاح پرس و جو است. یک اصطلاح پرس و جو به عنوان مقدار یک پارامتر در درخواست جستجو ظاهر می شود.

اصطلاحات پرس و جو می توانند چندین نوع اطلاعات را برای فیلتر و سازماندهی نتایج جستجو که گوگل باز می گرداند ، مشخص کند. نمایش داده شد می توانند مشخص کنند:

  • کلمات یا عبارات برای شامل یا حذف
    • همه کلمات موجود در یک پرس و جو جستجو (پیش فرض)
    • یک عبارت دقیق در پرس و جو جستجو
    • هر کلمه یا عبارت در یک پرس و جو جستجو
  • جایی که در یک سندی برای جستجوی اصطلاحات جستجو
    • در هر نقطه از سند (پیش فرض)
    • فقط در بدنه سند
    • فقط در عنوان سند
    • فقط در URL سند
    • فقط در پیوندها در سند
  • محدودیت های مربوط به خود اسناد
    • از جمله یا حذف اسناد از انواع پرونده های خاص (مانند پرونده های PDF یا اسناد Word)
  • پرس و جوهای ویژه URL که به جای انجام یک جستجو ، اطلاعات مربوط به URL خاص را باز می گردانند
    • نمایش داده شدی که اطلاعات کلی در مورد URL ، مانند دسته دایرکتوری باز آن ، قطعه یا زبان را برمی گرداند
    • نمایش داده شدی که مجموعه صفحات وب را که به URL پیوند دارند باز می گردانند
    • نمایش داده شدی که مجموعه ای از صفحات وب مشابه URL معین را برمی گرداند

جستجوی پیش فرض

مقادیر پارامتر پرس و جو جستجو باید URL باشد. توجه داشته باشید که شما می توانید علامت به علاوه ("+") را برای هر دنباله ای از فضای سفید در پرس و جو جستجو جایگزین کنید. این موضوع در بخش فرار URL این سند بحث شده است.

اصطلاح پرس و جو جستجو با استفاده از پارامتر Q به سرویس WebSearch ارسال می شود. یک اصطلاح پرس و جو جستجوی نمونه:

q=horses+cows+pigs

به طور پیش فرض ، سرویس Google WebSearch فقط اسنادی را که شامل تمام اصطلاحات موجود در پرس و جو جستجو است ، برمی گرداند.

درخواست پارامترها

در این بخش پارامترهایی که می توانید هنگام تهیه درخواست جستجو استفاده کنید ، ذکر شده است. پارامترها به دو لیست تقسیم می شوند. لیست اول شامل پارامترهایی است که مربوط به کلیه درخواست های جستجو است. لیست دوم شامل پارامترهایی است که فقط مربوط به درخواست های جستجوی پیشرفته است.

سه پارامتر درخواست مورد نیاز است:

  • پارامتر مشتری باید روی google-csbe تنظیم شود
  • پارامتر خروجی قالب نتایج XML برگشتی را مشخص می کند. نتایج را می توان با (XML) یا بدون ( xml_no_dtd ) ارجاع به DTD Google برگرداند. توصیه می کنیم این مقدار را روی xml_no_dtd تنظیم کنید. توجه: اگر این پارامتر را مشخص نکردید ، نتایج به جای XML در HTML بازگردانده می شوند.
  • پارامتر CX که نشان دهنده شناسه منحصر به فرد موتور است.

متداول ترین پارامترهای درخواست غیر از موارد ذکر شده در بالا عبارتند از:

  • شماره - تعداد درخواست شده نتایج جستجو
  • س - اصطلاح جستجو (ها)
  • شروع - شاخص شروع برای نتایج

نمونه نمایش داده های WebSearch

مثالهای زیر چند درخواست HTTP WebSearch را نشان می دهد تا نحوه استفاده از پارامترهای مختلف پرس و جو را نشان دهد. تعاریف مربوط به پارامترهای مختلف پرس و جو در تعاریف پارامتر WebSearch query و بخش های پیشرفته Parameters Parameters این سند ارائه شده است.

این درخواست 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

در این مثال از برخی از پارامترهای جستجوی پیشرفته جستجو برای شخصی سازی بیشتر پرس و جو جستجو استفاده می شود. این درخواست به جای پارامتر 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

تعاریف پارامتر پرس و جو WebSearch

c2coff
توضیحات

اختیاری پارامتر C2COFF ویژگی جستجوی ساده و سنتی چینی را امکان پذیر یا غیرفعال می کند.

مقدار پیش فرض این پارامتر 0 (صفر) است ، به این معنی که این ویژگی فعال است. مقادیر پارامتر c2coff عبارتند از:

ارزش اقدام
1 از کار افتاده است
0 فعال شد
نمونه ها q=google&c2coff=1
مشتری
توضیحات

مورد نیاز . پارامتر client باید روی google-csbe تنظیم شود.

نمونه ها q=google&client=google-csbe
cr
توضیحات

اختیاری پارامتر cr نتایج جستجو را به اسنادی که در یک کشور خاص سرچشمه می گیرد محدود می کند. ممکن است از اپراتورهای بولی در مقدار پارامتر cr استفاده کنید.

Google WebSearch کشور یک سند را با تجزیه و تحلیل تعیین می کند:

  • دامنه سطح بالا (TLD) URL سند
  • موقعیت جغرافیایی آدرس IP سرور وب

برای لیست مقادیر معتبر برای این پارامتر به بخش مقادیر پارامتر کشور (CR) مراجعه کنید.

نمونه ها q=Frodo&cr=countryNZ
cx
توضیحات

مورد نیاز . پارامتر cx یک کد منحصر به فرد را مشخص می کند که موتور جستجوی سفارشی را مشخص می کند. برای بازیابی نتایج جستجو از آن موتور باید یک موتور جستجوگر قابل برنامه ریزی را با استفاده از پارامتر cx مشخص کنید.

برای یافتن مقدار پارامتر cx ، به صفحه کنترل پنل> کدهای موتور خود بروید و آن را در قسمت متن در زیر "این کد در صفحه قرار دهید که دوست دارید جعبه جستجوی شما ظاهر شود ، پیدا خواهید کرد. نتایج جستجو در یک صفحه میزبان Google نشان داده می شود.

نمونه ها q=Frodo&cx=00255077836266642015:u-scht7a-8i
فیلتر
توضیحات

اختیاری پارامتر فیلتر فیلتر خودکار نتایج جستجوی Google را فعال یا غیرفعال می کند. برای اطلاعات بیشتر در مورد فیلترهای نتایج جستجوی Google ، به بخش فیلتر خودکار این سند مراجعه کنید.

مقدار پیش فرض برای پارامتر filter 1 است که نشان می دهد این ویژگی فعال است. مقادیر معتبر برای این پارامتر عبارتند از:

ارزش اقدام
1 از کار افتاده است
0 فعال شد

توجه: به طور پیش فرض ، Google برای بهبود کیفیت آن نتایج ، فیلتر را برای تمام نتایج جستجو اعمال می کند.

نمونه ها q=google&filter=0
gl
توضیحات

اختیاری مقدار پارامتر gl یک کد کشور دو حرف است. برای نتایج WebSearch ، پارامتر gl نتایج جستجو را افزایش می دهد که کشور مبدا با مقدار پارامتر مطابقت دارد. برای لیستی از مقادیر معتبر به بخش کدهای کشور مراجعه کنید.

تعیین مقدار پارامتر gl در درخواست های WebSearch باید ارتباط نتایج را بهبود بخشد. این امر به ویژه در مورد مشتریان بین المللی و حتی به طور خاص برای مشتریان در کشورهای انگلیسی زبان غیر از ایالات متحده صادق است.

نمونه ها

این درخواست اسنادی را که در انگلستان در نتایج WebSearch نوشته شده است ، تقویت می کند:
q=pizza&gl=uk
hl
توضیحات

اختیاری پارامتر hl زبان رابط (زبان میزبان) رابط کاربری شما را مشخص می کند. برای بهبود عملکرد و کیفیت نتایج جستجوی خود ، شما به شدت تشویق می شوید که این پارامتر را صریح تنظیم کنید.

برای کسب اطلاعات بیشتر و زبان های رابط پشتیبانی شده برای لیستی از زبانهای پشتیبانی شده ، به بخش رابط زبانهای بین المللی و ارائه نتایج ارائه می شود.

نمونه ها

این درخواست تبلیغات شراب را به زبان فرانسه هدف قرار می دهد. ( وین اصطلاح فرانسوی برای شراب است.)

q=vin&ip=10.10.10.10&ad=w5& hl=fr

hq
توضیحات

اختیاری پارامتر hq شرایط پرس و جو مشخص شده را به پرس و جو اضافه می کند ، گویی که آنها با یک اپراتور منطقی و اپراتور ترکیب شده اند.

نمونه ها

این درخواست به دنبال "پیتزا" و "پنیر" است. عبارت همان q=pizza+cheese است.

q=pizza&hq=cheese


یعنی
توضیحات

اختیاری پارامتر ie طرح رمزگذاری کاراکتر را که باید برای تفسیر رشته پرس و جو استفاده شود ، تنظیم می کند. مقدار ie پیش فرض latin1 است.

بخش رمزگذاری کاراکتر را برای بحث در مورد اینکه چه زمانی ممکن است از این پارامتر استفاده کنید ، مشاهده کنید.

برای لیست مقادیر ie ممکن ، بخش طرح های رمزگذاری کاراکتر را مشاهده کنید.

نمونه ها q=google&ie=utf8&oe=utf8
lr
توضیحات

اختیاری پارامتر lr (محدود کننده زبان) نتایج جستجو را به اسنادی که به یک زبان خاص نوشته شده اند محدود می کند.

Google WebSearch با تجزیه و تحلیل: زبان یک سند را تعیین می کند:

  • دامنه سطح بالا (TLD) URL سند
  • برچسب های متا زبان در سند
  • زبان اصلی مورد استفاده در متن بدن سند
  • زبانهای ثانویه ، در صورت وجود ، در متن بدن سند استفاده می شود

برای لیست مقادیر معتبر برای این پارامتر ، بخش مقادیر مجموعه زبان ( lr ) را مشاهده کنید.

نمونه ها q=Frodo&lr=lang_en
تعداد
توضیحات

اختیاری پارامتر num تعداد نتایج جستجو را برای بازگشت مشخص می کند.

مقدار پیش فرض num 10 و حداکثر مقدار 20 است. اگر بیش از 20 نتیجه بخواهید ، فقط 20 نتیجه بازگردانده می شود.

توجه: اگر تعداد کل نتایج جستجو کمتر از تعداد درخواست شده نتایج باشد ، تمام نتایج جستجوی موجود بازگردانده می شود.

نمونه ها q=google& num=10
oe
توضیحات

اختیاری The oe parameter sets the character encoding scheme that should be used to decode the XML result. The default oe value is latin1 .

See the Character Encoding section for a discussion of when you might need to use this parameter.

See the Character Encoding Schemes section for the list of possible oe values.

نمونه ها q=google&ie=utf8& oe=utf8
خروجی
توضیحات

مورد نیاز . The output parameter specifies the format of the XML results. The only valid values for this parameter are xml and xml_no_dtd . The chart below explains how these parameter values differ.

ارزش فرمت خروجی
xml_no_dtd The XML results will not include a !DOCTYPE statement. (توصیه می شود)
xml The XML results will contain a Google DTD reference. The second line of the result will identify the document definition type (DTD) that the results use: 
    <!DOCTYPE GSP SYSTEM "google.dtd">
نمونه ها output=xml_no_dtd
output=xml

q
توضیحات

اختیاری The q parameter specifies the search query entered by the user. Even though this parameter is optional, you must specify a value for at least one of the query parameters ( as_epq , as_lq , as_oq , as_q to get search results.

There are also a number of special query terms that can be used as part of the q parameter's value. Please see Special Query Terms for a list and definitions of these terms.

The Google Search Control Panel includes a report of the top queries submitted using the q parameter.

Note: The value specified for the q parameter must be URL-escaped.

نمونه ها q=vacation &as_oq=london+paris

امن
توضیحات

اختیاری The safe parameter indicates how search results should be filtered for adult and pornographic content. The default value for the safe parameter is off . Valid parameter values are:

ارزش اقدام
off Disable SafeSearch
medium Enable SafeSearch
high Enable a stricter version of SafeSearch

See the Filtering Adult Content with SafeSearch section for more details about this feature.

نمونه ها q=adult&safe=high
شروع کنید
توضیحات

اختیاری The start parameter indicates the first matching result that should be included in the search results. The start parameter uses a zero-based index, meaning the first result is 0, the second result is 1 and so forth.

The start parameter works in conjunction with the num parameter to determine which search results to return. Note that no more than 1000 results will ever be returned for any query, even if more than 1000 documents match the query, so setting start to 1000 or more will produce no results.

نمونه ها start=10

مرتب کردن
توضیحات

اختیاری The sort parameter specifies that the results be sorted according to the specified expression. For example, sort by date.

نمونه ها

sort=date


ud
توضیحات

اختیاری The ud parameter indicates whether the XML response should include the IDN-encoded URL for the search result. IDN (International Domain Name) encoding allows domains to be displayed using local languages, for example:

http://www.花井鮨.com

Valid values for this parameter are 1 (default), meaning the XML result should include IDN-encoded URLs, and 0 , meaning the XML result should not include IDN-encoded URLs. If the ud parameter is set to 1 , the IDN-encoded URL will appear in in the UD tag in your XML results.

If the ud parameter is set to 0 , the URL in the example above would be displayed as:

http://www.xn--elq438j.com.

Note: This is a beta feature.

نمونه ها q=google&ud=1

The additional query parameters listed below the image are relevant to advanced search queries. When you submit an advanced search, the values of several parameters (eg as_eq , as_epq , as_oq , etc.) are all factored into the query terms for that search. The image shows Google's Advanced Search page. On the image, the name of each advanced search parameter is written in red text inside of or next to the field on the page to which that parameter corresponds.



Advanced Search Query Parameters

as_dt
توضیحات

اختیاری The as_dt parameter controls whether to include or exclude results from the site named in the as_sitesearch parameter. The values i and e denote inclusion and exclusion respectively.

نمونه ها as_dt=i,as_dt=e

as_epq
توضیحات

اختیاری The as_epq parameter identifies a phrase that all documents in the search results must contain. You can also use the phrase search query term to search for a phrase.

نمونه ها as_epq=abraham+lincoln
as_eq
توضیحات

اختیاری The as_eq parameter identifies a word or phrase that should not appear in any documents in the search results. You can also use the exclude query term to ensure that a particular word or phrase will not appear in the documents in a set of search results.

نمونه ها

q=bass&as_eq=music .


as_lq
توضیحات

اختیاری The as_lq parameter specifies that all search results should contain a link to a particular URL. You can also use the link: query term for this type of query.

نمونه ها

as_lq=www.google.com


as_nlo
توضیحات

اختیاری The as_nlo parameter specifies the starting value for a search range. Use as_nlo and as_nhi to append an inclusive search range of as_nlo...as_nhi to the query.

نمونه ها

The following sets a search range of 5 to 10, inclusive:

as_nlo=5&as_nhi=10

as_nhi
توضیحات

اختیاری The as_nhi parameter specifies the ending value for a search range. Use as_nlo and as_nhi to append an inclusive search range of as_nlo...as_nhi to the query.

نمونه ها

The following sets a search range of 5 to 10, inclusive:

as_nlo=5&as_nhi=10

as_oq
توضیحات

اختیاری The as_oq parameter provides additional search terms to check for in a document, where each document in the search results must contain at least one of the additional search terms. You can also use the Boolean OR query term for this type of query.

نمونه ها

q=vacation&as_oq=London+Paris
as_q
توضیحات

اختیاری The as_q parameter provides search terms to check for in a document. This parameter is also commonly used to allow users to specify additional terms to search for within a set of search results.

نمونه ها

q=president&as_q=John+Adams


as_qdr
توضیحات

اختیاری The as_qdr parameter requests search results from a specified time period (quick date range). مقادیر زیر پشتیبانی می شوند:

d[number] requests results from the specified number of past days.
w[number] requests results from the specified number of past weeks.
m[number] requests results from the specified number of past months.
y[number] requests results from the specified number of past years.

نمونه ها

This example requests results from the past year:

as_qdr=y

This example requests results from the past 10 days:

as_qdr=d10

as_sitesearch
توضیحات

اختیاری The as_sitesearch parameter allows you to specify that all search results should be pages from a given site. By setting the as_dt parameter, you can also use it to exclude pages from a given site from your search resutls.

نمونه ها

q=vacation&as_sitesearch=www.google.com


Special Query Terms

Google WebSearch allows the use of several special query terms that access additional capabilities of the Google search engine. These special query terms should be included in the value of the q request parameter. Like other query terms, the special query terms must be URL-escaped . A number of the special query terms contain a colon (:). This character must also be URL-escaped; its URL-escaped value is %3A .

Back Links [link:]
توضیحات

The link: query term retrieves the set of Web pages that link to a particular URL. The search query should be formatted as link:URL with no space between the link: query term and the URL.

The URL-escaped version of link: is link%3A .

You can also use the as_lq request parameter to submit a link: request.

Note: You cannot specify any other query terms when using link: .

نمونه ها

http://www.google.com/search? q=link%3Awww.example.com
Boolean OR Search [ OR ]
توضیحات

The OR query term retrieves documents that include one of a series of (two or more) query terms. To use the OR query term, you would insert the search term OR , in uppercase letters, between each term in the series.

You can also use the as_oq request parameter to submit a search for any term in a set of terms.

Note: If a search request specifies the query "London+OR+Paris", the search results will include documents containing at least one of those two words. In some cases, documents in the search results may contain both words.

نمونه ها

Search for London or Paris:

User input: london OR paris Query term: q=london+OR+paris

Search for vacation and either London or Paris:

Query term: q=vacation+london+OR+paris

Search for vacation and one of London, Paris or chocolates:

Query term: q=vacation+london+OR+paris+OR+chocolates

Search for vacation and chocolates and either london or paris, with the least weight being given to chocolates:

Query term: q=vacation+london+OR+paris+chocolates

Search for vacation, chocolates and flowers in documents that also contain either London or Paris:

Query term: q=vacation+london+OR+paris+chocolates+flowers

Search for vacation and one of London or Paris and also search for one of chocolates or flowers:

Query term: q=vacation+london+OR+paris+chocolates+OR+flowers
Exclude Query Term [-]
توضیحات

The exclude ( - ) query term restricts results for a particular search request to documents that do not contain a particular word or phrase. To use the exclude query term, you would preface the word or phrase to be excluded from the matching documents with "-" (a minus sign).

The URL-escaped version of - is %2D .

The exclude query term is useful when a search term has more than one meaning. For example, the word "bass" could return results about either fish or music. If you were looking for documents about fish, you could exclude documents about music from your search results by using the exclude query term.

You can also use the as_eq request parameter to exclude documents matching a particular word or phrase from search results.

نمونه ها User input: bass -music
Query term: q=bass+ %2Dmusic
File Type Exclusion [ -filetype: ]
توضیحات

The -filetype: query term excludes documents with a particular file extension, such as ".pdf" or ".doc" from search results. The search query should be formatted as -filetype:EXTENSION with no space between the -filetype: query term and the specified extension.

The URL-escaped version of -filetype: is %2Dfiletype%3A .

Note: You can exclude multiple file types from search results by adding more -filetype: query terms to your query. You should have one -filetype: query term in your search query for each file extension that should be excluded from the search results.

Filetypes supported by Google include:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (rtf)
  • Shockwave Flash (swf)
  • Text (ans, txt).

Additional filetypes may be added in the future. An up-to-date list can always be found in Google's file type FAQ .

نمونه ها

This example returns documents that mention "Google" but that are not PDF documents:
q=Google+ %2Dfiletype%3Apdf

This example returns documents that mention "Google" but excludes both PDF and Word documents:
q=Google+ %2Dfiletype%3Apdf+%2Dfiletype%3Adoc
File Type Filtering [ filetype: ]
توضیحات

The filetype: query term restricts search results to documents with a particular file extension, such as ".pdf" or ".doc". The search query should be formatted as filetype:EXTENSION with no space between the filetype: query term and the specified extension.

The URL-escaped version of filetype: is filetype%3A .

You can restrict search results to documents matching one of several file extensions by adding more filetype: query terms to your query. You should have one filetype: query term in your search query for each file extension that should be included in the search results. Multiple filetype: query terms must be separated using the OR query term.

By default, search results will include documents with any file extension.

Filetypes supported by Google include:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • Lotus 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • Lotus WordPro (lwp)
  • Macwrite (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • Rich Text Format (rtf)
  • Shockwave Flash (swf)
  • Text (ans, txt).

Additional filetypes may be added in the future. An up-to-date list can always be found in Google's file type FAQ .

نمونه ها

This example returns PDF documents that mention "Google":
q=Google+ filetype%3Apdf

This example returns PDF and Word documents that mention "Google":
q=Google+ filetype%3Apdf+OR+filetype%3Adoc
Include Query Term [+]
توضیحات

The include (+) query term specifies that a word or phrase must occur in all documents included in the search results. To use the include query term, you would preface the word or phrase that must be included in all search results with "+" (a plus sign).

The URL-escaped version of + (a plus sign) is %2B .

You should use + before a common word that Google normally discards before identifying search results.

نمونه ها User input: Star Wars Episode +I
Query term: q=Star+Wars+Episode+ %2BI
Links Only Search, all terms [ allinlinks: ]
توضیحات

The allinlinks: query term requires documents in search results to contain all of the words in the search query in URL links. The search query should be formatted as allinlinks: followed by the words in your search query.

If your search query includes the allinlinks: query term, Google will only check the URL links in documents for the words in your search query, ignoring other text in the documents, the document titles and the URLs of each document. Note that the document URL is different from the URL links contained in the document.

The URL-escaped version of allinlinks: is allinlinks%3A .

نمونه ها User input: allinlinks: Google search
Query term: q= allinlinks%3A+Google+search
Phrase Search
توضیحات

The phrase search (") query term allows you to search for complete phrases by enclosing the phrases in quotation marks or by connecting them with hyphens.

The URL-escaped version of " (a quotation mark) is %22 .

Phrase searches are particularly useful if you are searching for famous quotes or proper names.

You can also use the as_epq request parameter to submit a phrase search.

نمونه ها User input: "Abraham Lincoln"
Query term: q= %22Abraham+Lincoln%22
Text Only Search, all terms [allintext:]
توضیحات

The allintext: query term requires each document in the search results to contain all of the words in the search query in the body of the document. The query should be formatted as allintext: followed by the words in your search query.

If your search query includes the allintext: query term, Google will only check the body text of documents for the words in your search query, ignoring links in those documents, document titles and document URLs.

The URL-escaped version of allintext: is allintext%3A .

نمونه ها This example specifies that the words "Google" and "search" must appear in the body of all documents included in the search results:
User input: allintext:Google search
Query term: q=allintext%3AGoogle+search
Title Search, single term [intitle:]
توضیحات

The intitle: query term restricts search results to documents that contain a particular word in the document title. The search query should be formatted as intitle:WORD with no space between the intitle: query term and the following word.

Note: You can specify more than one word that must be included in the document title by putting the intitle: query term in front of each such word. You can also use the allintitle: query term to specify that all query words must be included in the titles of documents that are in the search results.

The URL-escaped version of intitle: is intitle%3A .

نمونه ها

This example specifies that the word "Google" must appear in the titles of any documents in the search results, and the word "search" must appear anywhere in the titles, URLs, links or body text of those documents:
User input: intitle:Google search
Query term: q= intitle%3AGoogle+search
Title Search, all terms [allintitle:]
توضیحات

The allintitle: query term restricts search results to documents that contain all of the query words in the document title. To use the allintitle: query term, include "allintitle:" at the start of your search query.

Note: Putting allintitle: at the beginning of a search query is equivalent to putting intitle: in front of each word in the search query.

The URL-escaped version of allintitle: is allintitle%3A .

نمونه ها

This example specifies that the words "Google" and "search" must appear in the titles of any documents in the search results:
User input: allintitle: Google search
Query term: q= allintitle%3A+Google+search
URL Search, single term [inurl:]
توضیحات

The inurl: query term restricts search results to documents that contain a particular word in the document URL. The search query should be formatted as inurl:WORD with no space between the inurl: query term and the following word.

The inurl: query term ignores punctuation and uses only the first word following the inurl: operator. You can specify more than one word that must be included in the document URL by putting the inurl: query term in front of each such word. You can also use the allinurl: query term to specify that all query words must be included in the URLs of documents that are in the search results.

The URL-escaped version of inurl: is inurl%3A .

نمونه ها

This example specifies that the word "Google" must appear in the URLs of any documents in the search results, and the word "search" must appear anywhere in the titles, URLs, links or body text of those documents:
User input: inurl:Google search
Query term: q= inurl%3AGoogle+search
URL Search, all terms [allinurl:]
توضیحات

The allinurl: query term restricts search results to documents that contain all of the query words in the document URL. To use the allinurl: query term, include allinurl: at the start of your search query.

The allinurl: query term ignores punctuation, so it works only on words, not on URL components. For example, allinurl: uk/scotland will restrict results to documents that contain the words "uk" and "scotland" in their URLs, but will not require that those two words appear in any particular order or that they be separated by a slash.

The URL-escaped version of allinurl: is allinurl%3A .

نمونه ها

This example specifies that the words "Google" and "search" must appear in the URLs of any documents in the search results:
User input: allinurl: Google search
Query term: q= allinurl%3A+Google+search



Web Document Info [info:]
توضیحات

The info: query term retrieves general information about a URL as long as that URL is included in Google's search index. The search query should be formatted as info:URL with no space between the info: query term and the URL.

The URL-escaped version of info: is info%3A .

Note: You cannot specify any other query terms when using info: .

نمونه ها User input: info:www.google.com
Query term: q= info%3Awww.google.com

Sample Image Queries

The examples below show a couple of Image HTTP requests to illustrate how different query parameters are used. Definitions for the different query parameters are provided in the Image Query Parameter Definitions sections of this document.

This request asks for the first 5 results ( start=0&num=5 ) for the query term "monkey" ( q=monkey ), of filetype .png. Finally, the query specifies values for the client , output , and cx parameters, all three of which are required.

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

Image Search Query Parameters

as_filetype
توضیحات

اختیاری Returns images of a specified type. Allowed values are: bmp , gif , png , jpg , and svg .

نمونه ها q=google&as_filetype=png

imgsz
توضیحات

اختیاری Returns images of a specified size, where size can be one of:

  • icon (small)
  • small|medium|large|xlarge (medium)
  • xxlarge (large)
  • huge (extra-large)

نمونه ها q=google&as_filetype=png&imgsz=icon

imgtype
توضیحات

اختیاری Returns images of a type, which can be one of:

  • clipart (clipart)
  • face (face)
  • lineart (lineart)
  • news (news)
  • photo (photo)

نمونه ها q=google&as_filetype=png&imgtype=photo

imgc
توضیحات

اختیاری Returns black and white, grayscale, or color images:

  • mono (black and white)
  • gray (grayscale)
  • color (color)

نمونه ها q=google&as_filetype=png&imgc=gray

imgcolor
توضیحات

اختیاری Returns images of a specific dominant color:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
نمونه ها q=google&as_filetype=png&imgcolor=yellow

as_rights
توضیحات

اختیاری Filters based on licensing. Supported values include:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

نمونه ها q=cats&as_filetype=png&as_rights=cc_attribute

Request Limits

The chart below lists limitations on the search requests that you send to Google:

جزء محدود کنید نظر دهید
Search request length 2048 بایت
Number of query terms 10 includes terms in the following parameters: q , as_epq , as_eq , as_lq , as_oq , as_q
Number of results 20 If you set the num parameter to a number greater than 20, only 20 results are returned. To get more results, you would need to send multiple requests and increment the value of the start parameter with each request.

Internationalizing Queries and Results Presentation

The Google WebSearch service enables you to search for documents in multiple languages. You can specify the character encoding that should be used to interpret your HTTP request and to encode your XML response (using the ie and oe search parameters). You can also filter results to only include documents written in certain languages.

The following sections discuss issues related to searching in multiple languages:

Character Encoding

Servers send data, such as web pages, to user agents, such as browsers, as a sequence of encoded bytes. The user agent then decodes the bytes into a sequence of characters. When sending requests to the WebSearch service, you can specify the encoding schemes for both your search query and for the XML response that you receive.

You can use the ie request parameter to specify the encoding mechanism for the characters in your HTTP request. You can also use the oe parameter to specify the encoding scheme that Google should use to encode your XML response. If you are using an encoding scheme other than ISO-8859-1 (or latin1 ), please ensure that you specify the correct values for the ie and oe parameters.

Note: If you are providing search functionality for multiple languages, we recommend you use the utf8 (UTF-8) encoding value for both the ie and oe parameters.

Please refer to the Character Encoding Schemes appendix for a complete list of the values that you can use for the ie and oe parameters.

For more general information about character encoding, please see http://www.w3.org/TR/REC-html40/charset.html .

Interface Languages

You can use the hl request parameter to identify the language of your graphical interface. The hl parameter value may affect XML search results, especially on international queries when language restriction (using the lr parameter) is not explicitly specified. In such cases, the hl parameter may promote search results in the same language as the user's input language.

We suggest you explicitly set the hl parameter in search results to ensure that Google selects the highest quality search results for each query.

Please see the Supported Interface Languages section for a complete list of valid values for the hl parameter.

Searching for Documents Written in Specific Languages

You can use the lr request parameter to restrict search results to documents that are written in a particular language or set of languages.

The lr parameter supports Boolean Operators to allow you to specify multiple languages that should be included (or excluded) from search results.

The following examples show how you might use Boolean Operators to request documents in different languages.

For documents written in Japanese:

lr=lang_jp

For documents written in Italian or German:

lr=lang_it|lang_de

For documents not written in Hungarian or Czech:

lr=(-lang_hu).(-lang_cs)

Please see the Language Collection Values section for a complete list of possible values for the lr parameter and the Boolean Operators section for a complete discussion of the use of these operators.

Simplified Chinese and Traditional Chinese are two writing variants of the Chinese language. The same concept may be written differently in each variant. Given a query in one of the variants, the Google WebSearch service can return results that include pages in both variants.

برای استفاده از این قابلیت:

  1. Set the c2coff request parameter to 0
    و
  2. یکی از کارهای زیر را انجام دهید:
    • Do not set the lr request parameter
      یا
    • Set the lr request parameter to lr=lang_zh-TW|lang_zh-CN

The following example shows the query parameters you would include in a request for results in both simplified and traditional Chinese. (Note that additional required information, such as the client , is not included in the example.)

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

Filtering Results

Google WebSearch provides a number of ways to filter your search results:

Automatic Filtering of Search Results

In an effort to provide the best search results possible, Google uses two techniques to automatically filter search results that are generally considered undesirable:

  • Duplicate Content —If multiple documents contain the same information, then only the most relevant document of that set is included in your search results.

  • Host Crowding —If there are many search results from the same site, Google may not show all the results from that site or may show the results lower in
    the ranking than they otherwise would have been.

We recommend you leave these filters on for typical search requests because the filters significantly enhance the quality of most search results. However, you can bypass these automatic filters by setting the filter query parameter to 0 in your search request.

Language and Country Filtering

The Google WebSearch service returns results from a master index of all Web documents. The master index contains subcollections of documents that are grouped by particular attributes, including language and country of origin.

You can use the lr and cr request parameters to restrict search results to subcollections of documents that are written in particular languages or originate from particular countries, respectively.

Google WebSearch determines the language of a document by analyzing:

  • the top-level domain (TLD) of the document's URL
  • language meta tags within the document
  • the primary language used in the body text of the document


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

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 "&amp;". The XML Standard documents these characters; these characters are reproduced in the table below:

    شخصیت Escaped Forms موجودیت کد کاراکتر
    آمپرسند & &amp; &#38;
    نقل قول واحد ' &apos; &#39;
    دو نقل قول " &quot; &#34;
    بزرگتر از > &gt; &#62;
    کمتر از < &آن؛ &#60;

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:

? = optional subtag
* = zero or more instances of the subtag
+ = one or more instances of the subtag
الف ب سی دی اف جی اچ من L م ن پ س آر اس تی U X

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
فرمت محتوا متن
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
فرمت محتوا خالی

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
فرمت محتوا خالی
سی
تعریف

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.

صفات
نام قالب توضیحات
SZ Text (Integer + "k") Provides the size of the cached version of the search result in kilobytes ("k").
CID متن Identifies a document in Google's cache. To fetch the document from the cache, send a search term built as follows:
cache: CIDtext : escapedURL

The escaped URL is available in the UE tag.

مثال <C SZ="6k" CID="kvOXK_cYSSgJ" />
Subtag of دارد
فرمت محتوا خالی
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.
فرمت محتوا متن
زمینه
تعریف

The <Context> tag encapsulates a list of refinement labels associated with a set of search results.

مثال <Context>
Subtags title , Facet +
فرمت محتوا ظرف

CRAWLDATE
تعریف

The <CRAWLDATE> tag identifies the date that the page was last crawled. CRAWLDATE is not returned for every search result page.

مثال <CRAWLDATE>May 21, 2005</CRAWLDATE>
Subtag of آر
فرمت محتوا متن
DI
تعریف

The <DI> tag encapsulates Open Directory Project (ODP) category information for a single search result.

مثال <DI>
Subtags DT ?, DS ?
Subtag of دارد
فرمت محتوا خالی
DS
تعریف

The <DS> tag provides the summary listed for a single category in the ODP directory.

مثال <DS>Post your &lt;b&gt;soccer&lt;/b&gt; resume directly on the Internet.</DS>
Subtag of DI
فرمت محتوا Text (may contain HTML)
DT
تعریف

The <DT> tag provides the title for a single category listed in the ODP directory.

مثال <DT>SoccerConnection.net</DT>
Subtag of DI
فرمت محتوا Text (may contain HTML)
جنبه
تعریف

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 زمینه
فرمت محتوا ظرف

FacetItem
تعریف

The <FacetItem> tag encapsulates information about a refinement label associated with a set of search results.

مثال <FacetItem>
Subtags label , anchor_text +
Subtag of جنبه
فرمت محتوا FacetItem
FI
تعریف 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
فرمت محتوا خالی
GSP
تعریف

The <GSP> tag encapsulates all data returned in Google XML search results. "GSP" is an abbreviation for "Google Search Protocol".

صفات
نام قالب توضیحات
VER Text (Integer) The VER attribute specifies the version of the search results output. The current output version is "3.2".
مثال <GSP VER="3.2">
Subtags PARAM +, Q , RES ?, TM
فرمت محتوا خالی
دارد
تعریف 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
فرمت محتوا خالی
L
تعریف 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 دارد
فرمت محتوا خالی
برچسب
تعریف

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
filter search results about Palm Springs:
    q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
    q=Palm+Springs+more%3Agolf_courses

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
فرمت محتوا متن
LANG
تعریف

The <LANG> tag contains Google's best guess of the language of the search result.

مثال <LANG>en</LANG>
Subtag of آر
فرمت محتوا متن
م
تعریف

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
فرمت محتوا متن
NB
تعریف

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
فرمت محتوا خالی
NU
تعریف

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 NB
فرمت محتوا 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.

صفات
نام قالب توضیحات
نام متن Input parameter name.
ارزش HTML HTML-formatted version of the input parameter value.
original_value متن Original URL-escaped version of the input parameter value.
مثال <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
Subtag of GSP
فرمت محتوا مجتمع
PU
تعریف

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 NB
فرمت محتوا 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
فرمت محتوا متن
آر
تعریف

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 .

صفات
نام قالب توضیحات
ن Text (Integer) Indicates the index (1-based) of this search result.
MIME متن Indicates the MIME type of the search result.
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.

صفات
نام قالب توضیحات
SN Text (Integer) Indicates the index (1-based) of the first search result returned in this result set.
EN Text (Integer) Indicates the index (1-based) of the last search result returned in this result set.
مثال <RES SN="1" EN="10">
Subtags M , FI ?, XT ?, NB ?, R *
Subtag of GSP
فرمت محتوا خالی
اس
تعریف

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 &lt;b&gt;Bush&#39;s&lt;/b&gt; judicial picks would let five nominees advance to a final vote while preserving the &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
Subtag of آر
فرمت محتوا 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
فرمت محتوا خالی
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 آر
فرمت محتوا خالی
املا
تعریف

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
فرمت محتوا خالی
پیشنهاد
تعریف 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.
صفات
نام قالب توضیحات
q متن The q attribute specifies the URL-escaped version of the spelling suggestion.
مثال <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion>
Subtag of املا
فرمت محتوا Text (HTML)
تی
تعریف The <T> tag contains the title of the result.
مثال <T>Amici's East Coast Pizzeria</T>
Subtag of آر
فرمت محتوا 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
فرمت محتوا متن
TM
تعریف

The <TM> tag identifies the total server time needed to return search results, measured in seconds.

مثال <TM>0.100445</TM>
Subtag of GSP
فرمت محتوا Text (Floating-point number)
TT
تعریف The <TT> tag provides a search tip.
مثال <TT>&lt;i&gt;Tip: For most browsers, pressing the Return key produces the same results as clicking the Search button.&lt;/i&gt;</TT>
Subtag of GSP
U
تعریف The <U> tag provides the URL of the search result.
مثال <U>http://www.dominos.com/</U>
Subtag of آر
فرمت محتوا Text (Absolute URL)
UD
تعریف

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 آر
فرمت محتوا Text (IDN-encoded URL)
UE
تعریف 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 آر
فرمت محتوا Text (URL-escaped URL)
XT
تعریف 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
فرمت محتوا خالی

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:

? = optional subtag
* = zero or more instances of the subtag
+ = one or more instances of the subtag

RG
تعریف

The <RG> tag encloses the details of an individual image search result.

صفات
نام قالب توضیحات
ن Text (Integer) Indicates the index (1-based) of this search result.
MIME متن Indicates the MIME type of the search result.
Subtag of RES
RU
تعریف

The <RU tag> tag encloses details of each image search result.

Subtag of آر