مرجع 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 بدون فاصله بین عبارت query 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-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 چندین روش برای فیلتر کردن نتایج جستجوی شما ارائه می دهد:

• فیلتر خودکار نتایج جستجو
• فیلتر زبان و کشور
• فیلتر کردن محتوای بزرگسالان با SafeSearch

فیلتر خودکار نتایج جستجو

در تلاش برای ارائه بهترین نتایج جستجو ممکن ، 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 سایت را به [e-mail] از طریق ایمیل ارسال کنید ، و ما سایت را بررسی خواهیم کرد.

نتایج XML

• Google XML نتایج DTD
• در مورد پاسخ XML
• نتایج XML برای نمایش داده های جستجوی منظم و پیشرفته
• جستجوی منظم/پیشرفته: نمونه پرس و جو و نتیجه XML
• جستجوی منظم/پیشرفته: برچسب های XML

Google XML نتایج DTD

Google از همان DTD برای توصیف قالب XML برای انواع نتایج جستجو استفاده می کند. بسیاری از برچسب ها و ویژگی ها برای انواع جستجو قابل استفاده است. با این حال ، برخی از برچسب ها فقط برای انواع جستجوی خاص قابل استفاده هستند. در نتیجه ، تعاریف موجود در DTD ممکن است محدود کننده تر از تعاریف ذکر شده در این سند باشد.

این سند جنبه های DTD را که برای WebSearch مرتبط هستند ، توصیف می کند. وقتی به DTD نگاه می کنید ، اگر در WebSearch کار می کنید ، می توانید با اطمینان از برچسب ها و ویژگی هایی که در اینجا ثبت نشده اند ، نادیده بگیرید. اگر تعریف بین DTD و مستندات متفاوت باشد ، این واقعیت در این سند ذکر شده است.

Google می تواند نتایج XML را با یا بدون مراجعه به جدیدترین DTD بازگرداند. DTD راهنمایی برای کمک به مدیران جستجو و پارسرهای XML است که نتایج XML Google را درک می کنند. از آنجا که گرامر XML Google ممکن است هر از گاهی تغییر کند ، شما نباید تجزیه کننده خود را پیکربندی کنید تا از DTD برای تأیید هر نتیجه XML استفاده کنید.

علاوه بر این ، شما نباید تجزیه و تحلیل XML خود را پیکربندی کنید تا هر بار که درخواست جستجو را ارسال کنید ، DTD را واکشی کنید. Google DTD را به ندرت به روز می کند ، و این درخواست ها تأخیر غیر ضروری و نیازهای پهنای باند را ایجاد می کنند.

Google توصیه می کند که برای دریافت نتایج XML از فرمت خروجی XML_NO_DTD استفاده کنید. اگر قالب خروجی XML را در درخواست جستجوی خود مشخص کنید ، تنها تفاوت در گنجاندن خط زیر در نتایج XML است:

<!DOCTYPE GSP SYSTEM "google.dtd">

می توانید به آخرین DTD در http://www.google.com/google.dtd دسترسی پیدا کنید.

لطفاً توجه داشته باشید که همه ویژگی های موجود در DTD ممکن است در این زمان در دسترس یا پشتیبانی شوند.

در مورد پاسخ XML

• تمام مقادیر عنصر معتبر HTML مناسب برای نمایش هستند مگر اینکه در تعاریف برچسب XML ذکر شده باشد.
• برخی از مقادیر عنصر URL هایی هستند که قبل از نمایش آنها باید رمزگذاری شوند.
• تجزیه کننده XML شما باید ویژگی ها و برچسب های بدون مدارک را نادیده بگیرد. اگر Google ویژگی های بیشتری را به خروجی XML اضافه کند ، این امکان را به شما می دهد تا بدون تغییر کار خود را ادامه دهد.
• شخصیت های خاصی باید در هنگام قرار گرفتن به عنوان مقادیر در برچسب های XML ، فرار شوند. پردازنده XML شما باید این موجودات را به شخصیت های مناسب تبدیل کند. اگر نهادها را به درستی تبدیل نکنید ، مرورگر ممکن است به عنوان مثال ، شخصیت را به عنوان "& amp ؛" ارائه دهد. استاندارد XML این شخصیت ها را مستند می کند. این شخصیت ها در جدول زیر بازتولید می شوند:

  شخصیت	فرم های فراری	وجود، موجودیت	رمز شخصیت
  ampersand	&	&	&#38 ؛
  نقل قول واحد	'	& apos ؛	&#39 ؛
  نقل قول مضاعف	"	"	&#34 ؛
  بزرگتر از	>	>	&#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

ایکس

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

مسدود کردن
تعریف	این برچسب محتویات یک بلوک را در یک خط بدنه از یک نتیجه ارتقاء محاصره می کند. هر بلوک دارای زیرمجموعه های t ، u و l است. یک برچسب t غیر خالی نشان می دهد که بلوک حاوی متن است. برچسب های U و L غیر خالی نشان می دهد که این بلوک حاوی پیوندی است (با URL در متن u subtag و anchor در زیر مجموعه L ).
زیرگروه	T ، U ، L
زیر مجموعه از	بدنه
قالب محتوا	خالی

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

سی
تعریف	برچسب <c> نشان می دهد که سرویس WebSearch می تواند یک نسخه ذخیره شده از این URL نتیجه جستجو را بازیابی کند. شما نمی توانید صفحات ذخیره شده را از طریق API XML بازیابی کنید ، اما می توانید کاربران را برای این محتوا به www.google.com هدایت کنید.
ویژگی های	نام قالب شرح 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
تعریف	برچسب <di> اطلاعات دسته ای از پروژه دایرکتوری باز (ODP) را برای یک نتیجه جستجوی واحد محصور می کند.
مثال	<di>
زیرگروه	dt ؟ ، ds ؟
زیر مجموعه از	دارد
قالب محتوا	خالی

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

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

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

قضیه
تعریف	برچسب <SacateTitem> اطلاعات مربوط به برچسب پالایش مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد.
مثال	<SaceTitem>
زیرگروه	برچسب ، anchor_text +
زیر مجموعه از	جنبه
قالب محتوا	قضیه

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

GSP
تعریف	برچسب <GSP> تمام داده های برگشتی در نتایج جستجوی Google XML را محصور می کند. "GSP" مخفف "پروتکل جستجوی Google" است.
ویژگی های	نام قالب شرح 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> حاوی بهترین حدس گوگل از زبان نتیجه جستجو است.
مثال	<lang> en </lang>
زیر مجموعه از	آر
قالب محتوا	متن

م
تعریف	برچسب <m> تعداد کل نتایج برای جستجو را مشخص می کند. توجه: این برآورد ممکن است دقیق نباشد.
مثال	<m> 16200000 </m>
زیر مجموعه از	RES
قالب محتوا	متن

NB
تعریف	برچسب <nb> اطلاعات ناوبری را به صفحه بعدی نتایج جستجو یا صفحه قبلی نتایج جستجو - برای مجموعه نتیجه می دهد. توجه: این برچسب فقط در صورت وجود نتایج بیشتر موجود است.
مثال	<nb>
زیرگروه	nu ؟ ، pu ؟
زیر مجموعه از	RES
قالب محتوا	خالی

NU
تعریف	برچسب <nu> حاوی پیوند نسبی به صفحه بعدی نتایج جستجو است.
مثال	<nu>/جستجو؟ q = گلها و num = 10 & hl = en & ie = utf-8 & output = xml & client = test & start = 10 </nu>
زیر مجموعه از	NB
قالب محتوا	متن (URL نسبی)

پارتی
تعریف	برچسب <param> یک پارامتر ورودی ارسال شده در درخواست HTTP مرتبط با نتیجه XML را مشخص می کند. اطلاعات مربوط به پارامتر در ویژگی های برچسب - نام ، مقدار ، Original_Value - موجود است و برای هر پارامتر ارسال شده در درخواست HTTP یک برچسب پارام وجود خواهد داشت.
ویژگی های	نام قالب شرح نام متن نام پارامتر ورودی. ارزش 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 مبتنی بر) این نتیجه جستجو را نشان می دهد. تقلید متن نوع تقلید نتیجه جستجو را نشان می دهد.
زیرگروه	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> 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 مبتنی بر) این نتیجه جستجو را نشان می دهد. تقلید متن نوع تقلید نتیجه جستجو را نشان می دهد.
زیر مجموعه از	RES

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