مرجع 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 از عملگرهای Boolean پشتیبانی می کند تا به شما امکان می دهد چندین زبان را که باید در نتایج جستجو گنجانده شوند (یا حذف شوند) را مشخص کنید.

مثال‌های زیر نشان می‌دهند که چگونه می‌توانید از عملگرهای Boolean برای درخواست اسناد به زبان‌های مختلف استفاده کنید.

برای اسناد نوشته شده به زبان ژاپنی:

lr=lang_jp

برای اسناد نوشته شده به ایتالیایی یا آلمانی:

lr=lang_it|lang_de

برای اسنادی که به زبان مجارستانی یا چکی نوشته نشده اند:

lr=(-lang_hu).(-lang_cs)

لطفاً بخش Language Collection Values ​​را برای فهرست کاملی از مقادیر ممکن برای پارامتر lr و بخش Boolean Operators را برای بحث کامل در مورد استفاده از این عملگرها ببینید.

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

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

  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 همه نتایج آن سایت را نشان ندهد یا نتایج را در پایین‌تر نشان دهد.
    رتبه ای که در غیر این صورت می توانستند داشته باشند.

توصیه می‌کنیم این فیلترها را برای درخواست‌های جستجوی معمولی روشن بگذارید زیرا فیلترها به طور قابل توجهی کیفیت اکثر نتایج جستجو را افزایش می‌دهند. با این حال، می توانید با تنظیم پارامتر query فیلتر روی 0 در درخواست جستجوی خود، از این فیلترهای خودکار عبور کنید.

فیلتر زبان و کشور

سرویس Google WebSearch نتایج را از فهرست اصلی همه اسناد وب برمی گرداند. فهرست اصلی شامل مجموعه‌های فرعی از اسناد است که بر اساس ویژگی‌های خاص، از جمله زبان و کشور مبدا گروه‌بندی می‌شوند.

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

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

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


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

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

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

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

توجه: می توانید مقادیر زبان و ارزش کشور را برای سفارشی کردن نتایج جستجو ترکیب کنید. به عنوان مثال، می توانید مدارکی را درخواست کنید که به زبان فرانسوی نوشته شده و از فرانسه یا کانادا آمده است، یا می توانید اسنادی را درخواست کنید که از هلند آمده و به زبان انگلیسی نوشته نشده باشند. پارامترهای lr و cr هر دو از عملگرهای Boolean پشتیبانی می کنند.

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

بسیاری از مشتریان گوگل نمی خواهند نتایج جستجوی سایت هایی را که حاوی محتوای بزرگسالان هستند نمایش دهند. با استفاده از فیلتر SafeSearch ما، می‌توانید نتایج جستجویی که حاوی محتوای بزرگسالان است را بررسی کنید و آنها را حذف کنید. فیلترهای گوگل از فناوری اختصاصی برای بررسی کلمات کلیدی، عبارات و URL ها استفاده می کنند. در حالی که هیچ فیلتری 100 درصد دقیق نیست، جستجوی ایمن اکثریت قریب به اتفاق محتوای بزرگسالان را از نتایج جستجوی شما حذف می کند.

Google با خزیدن مداوم در وب و با ترکیب به‌روزرسانی‌های پیشنهادات کاربران، تلاش می‌کند تا SafeSearch را تا حد ممکن به روز و جامع نگه دارد.

SafeSearch به زبان‌های زیر در دسترس است:

هلندی
انگلیسی
فرانسوی
آلمانی		 ایتالیایی
پرتغالی (برزیلی)
اسپانیایی
چینی سنتی

با استفاده از پارامتر جستجوی ایمن می‌توانید درجه فیلتر کردن نتایج شما را برای محتوای بزرگسالان توسط Google تنظیم کنید. جدول زیر تنظیمات SafeSearch Google را توضیح می دهد و این تنظیمات چگونه بر نتایج جستجوی شما تأثیر می گذارد:

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

* تنظیم پیش‌فرض SafeSearch خاموش است.

اگر SafeSearch را فعال کرده‌اید و سایت‌هایی را پیدا کردید که حاوی محتوای توهین‌آمیز هستند، لطفاً URL سایت را به safesearch@google.com ایمیل کنید و ما سایت را بررسی می‌کنیم.

نتایج XML

نتایج Google XML DTD

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

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

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

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

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

<!DOCTYPE GSP SYSTEM "google.dtd">

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

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

درباره پاسخ XML

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

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

نتایج XML برای پرس و جوهای جستجوی منظم و پیشرفته

جستجوی منظم/پیشرفته: پرس و جو نمونه و نتیجه XML

این نمونه درخواست جستجوی وب 10 نتیجه ( num=10 ) در مورد عبارت جستجوی "socer" ( q=socer ) درخواست می کند، که کلمه "soccer" عمداً برای این مثال اشتباه نوشته شده است.)

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

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

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

anchor_text
تعریف

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

مثال <anchor_text>زمین‌های گلف</anchor_text>
برچسب فرعی از FacetItem
فرمت محتوا متن
BLOCK
تعریف

این تگ محتویات یک بلوک را در یک خط بدنه یک نتیجه تبلیغاتی کپسوله می کند. هر بلوک دارای زیربرچسب‌های T ، U و L است. یک تگ T غیر خالی نشان می دهد که بلوک حاوی متن است. تگ های U و L غیر خالی نشان می دهد که بلوک حاوی یک پیوند است (با URL داده شده در زیربرچسب U و متن لنگر در زیربرچسب L ).

برچسب های فرعی تی ، یو ، ال
برچسب فرعی از BODY_LINE
فرمت محتوا خالی

BODY_LINE
تعریف

این تگ محتویات یک خط را در بدنه نتیجه تبلیغ شده کپسوله می کند. هر خط بدنه از چندین تگ BLOCK تشکیل شده است که یا حاوی مقداری متن یا پیوندی با URL و متن لنگر است.

برچسب های فرعی بلوک *
برچسب فرعی از SL_MAIN
فرمت محتوا خالی
سی
تعریف

تگ <C> نشان می دهد که سرویس WebSearch می تواند نسخه ذخیره شده این URL نتیجه جستجو را بازیابی کند. شما نمی توانید صفحات کش شده را از طریق XML API بازیابی کنید، اما می توانید کاربران را برای این محتوا به www.google.com هدایت کنید.

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

URL فرار در تگ UE موجود است.

مثال <C SZ="6k" CID="kvOXK_cYSSgJ" />
برچسب فرعی از دارد
فرمت محتوا خالی
C2C
تعریف تگ <C2C> نشان می دهد که نتیجه به صفحه زبان چینی سنتی اشاره دارد. این برچسب فقط زمانی ظاهر می شود که جستجوی ساده و سنتی چینی فعال باشد. برای اطلاعات بیشتر در مورد فعال و غیرفعال کردن این ویژگی به تعریف پارامتر query c2coff مراجعه کنید.
فرمت محتوا متن
زمینه
تعریف

تگ <Context> فهرستی از برچسب های اصلاحی مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد.

مثال <Context>
برچسب های فرعی عنوان , Facet +
فرمت محتوا ظرف

CRAWLDATE
تعریف

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

مثال <CRAWLDATE>21 مه 2005</CRAWLDATE>
برچسب فرعی از آر
فرمت محتوا متن
DI
تعریف

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

مثال <DI>
برچسب های فرعی DT ?، DS ?
برچسب فرعی از دارد
فرمت محتوا خالی
DS
تعریف

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

مثال <DS>&lt;b&gt;فوتبال&lt;/b&gt; مستقیماً در اینترنت از سر بگیرید.</DS>
برچسب فرعی از DI
فرمت محتوا متن (ممکن است حاوی HTML باشد)
DT
تعریف

تگ <DT> عنوان یک دسته بندی منفرد فهرست شده در فهرست ODP را فراهم می کند.

مثال <DT>SoccerConnection.net</DT>
برچسب فرعی از DI
فرمت محتوا متن (ممکن است حاوی HTML باشد)
جنبه
تعریف

تگ <Facet> حاوی یک گروه بندی منطقی از تگ های <FacetItem> است. شما می توانید این گروه بندی ها را با استفاده از فرمت مشخصات موتور جستجوی قابل برنامه ریزی XML ایجاد کنید. اگر این گروه بندی ها را ایجاد نکنید، تگ results_xml_tag_Context><Context> حداکثر دارای چهار تگ <Facet> خواهد بود. موارد موجود در هر تگ <Facet> برای اهداف نمایشی گروه بندی می شوند اما ممکن است رابطه منطقی نداشته باشند.

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

FacetItem
تعریف

تگ <FacetItem> اطلاعات مربوط به یک برچسب اصلاحی مرتبط با مجموعه ای از نتایج جستجو را در بر می گیرد.

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

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

صفات
نام قالب توضیحات
VER متن (عدد صحیح) ویژگی VER نسخه خروجی نتایج جستجو را مشخص می کند. نسخه خروجی فعلی "3.2" است.
مثال <GSP VER="3.2">
برچسب های فرعی PARAM +، Q ، RES ?، TM
فرمت محتوا خالی
دارد
تعریف تگ <HAS> اطلاعات مربوط به هر پارامتر درخواست جستجوی ویژه ای را که برای یک URL خاص پشتیبانی می شود، محصور می کند.

توجه: تعریف <HAS> برای جستجوی وب محدودتر از DTD است.

برچسب های فرعی DI ?, L ?, C ?, RT ?
برچسب فرعی از آر
ISURL
تعریف اگر عبارت جستجوی مرتبط یک URL باشد، گوگل تگ <ISURL> را برمی گرداند.
برچسب فرعی از GSP
فرمت محتوا خالی
L
تعریف وجود تگ <L> نشان می‌دهد که سرویس WebSearch می‌تواند سایت‌های دیگری را پیدا کند که به این URL نتیجه جستجو پیوند دارند. برای یافتن چنین سایت هایی، از پیوند: عبارت جستجوی ویژه استفاده می کنید.
برچسب فرعی از دارد
فرمت محتوا خالی
برچسب
تعریف

تگ <label> یک برچسب اصلاحی را مشخص می کند که می توانید از آن برای فیلتر کردن نتایج جستجویی که دریافت می کنید استفاده کنید. برای استفاده از برچسب اصلاح، رشته را بیشتر اضافه کنید: [[label tag value]] به مقدار پارامتر q در درخواست HTTP خود به Google همانطور که در مثال زیر نشان داده شده است. لطفاً توجه داشته باشید که قبل از ارسال پرس و جو به Google، این مقدار باید URL-Escape شود.

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>زمین_گلف</label>
برچسب فرعی از FacetItem
فرمت محتوا متن
LANG
تعریف

تگ <LANG> حاوی بهترین حدس گوگل از زبان نتیجه جستجو است.

مثال <LANG>en</LANG>
برچسب فرعی از آر
فرمت محتوا متن
م
تعریف

تگ <M> تعداد کل تخمینی نتایج جستجو را مشخص می کند.

توجه: این تخمین ممکن است دقیق نباشد.

مثال <M>16200000</M>
برچسب فرعی از RES
فرمت محتوا متن
NB
تعریف

تگ <NB> اطلاعات ناوبری - پیوندهایی به صفحه بعدی نتایج جستجو یا صفحه قبلی نتایج جستجو - را برای مجموعه نتایج محصور می کند.

توجه: این تگ فقط در صورتی وجود دارد که نتایج بیشتری در دسترس باشد.

مثال <NB>
برچسب های فرعی NU ?, PU ?
برچسب فرعی از RES
فرمت محتوا خالی
NU
تعریف

تگ <NU> حاوی یک پیوند نسبی به صفحه بعدی نتایج جستجو است.

مثال <NU>/search?q=flowers&num=10&hl=en&ie=UTF-8
&output=xml&client=test&start=10</NU>
برچسب فرعی از NB
فرمت محتوا متن (URL نسبی)
PARAM
تعریف

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

صفات
نام قالب توضیحات
نام متن نام پارامتر ورودی
ارزش HTML نسخه با فرمت HTML مقدار پارامتر ورودی.
ارزش_اصلی متن نسخه اصلی مقدار پارامتر ورودی بدون URL .
مثال <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
برچسب فرعی از GSP
فرمت محتوا مجتمع
PU
تعریف

تگ <PU> پیوندی نسبی به صفحه قبلی نتایج جستجو ارائه می دهد.

مثال <PU>/search?q=flowers&num=10&hl=en&output=xml
&client=test&start=10</PU>
برچسب فرعی از NB
فرمت محتوا متن (URL نسبی)
س
تعریف

تگ <Q> عبارت جستجوی ارسال شده در درخواست HTTP مرتبط با نتیجه XML را مشخص می کند.

مثال

<Q>پیتزا</Q>

برچسب فرعی از GSP
فرمت محتوا متن
آر
تعریف

تگ <R> جزئیات یک نتیجه جستجوی فردی را در بر می گیرد.

توجه: تعریف تگ <R> برای جستجوی وب محدودتر از DTD است.

صفات
نام قالب توضیحات
ن متن (عدد صحیح) نمایه (بر اساس 1) این نتیجه جستجو را نشان می دهد.
MIME متن نوع MIME نتیجه جستجو را نشان می دهد.
برچسب های فرعی U , UE , T ?, CRAWLDATE , S ?, LANG ?, HAS
برچسب فرعی از RES
RES
تعریف

تگ <RES> مجموعه ای از نتایج جستجوی فردی و جزئیات مربوط به آن نتایج را در بر می گیرد.

صفات
نام قالب توضیحات
SN متن (عدد صحیح) نمایه (بر اساس 1) اولین نتیجه جستجوی بازگشتی در این مجموعه نتایج را نشان می دهد.
EN متن (عدد صحیح) نمایه (بر اساس 1) آخرین نتیجه جستجوی بازگشتی در این مجموعه نتایج را نشان می دهد.
مثال <RES SN="1" EN="10">
برچسب های فرعی M , FI ?, XT ?, NB ?, R *
برچسب فرعی از GSP
فرمت محتوا خالی
اس
تعریف

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

مثال <S>واشنگتن (سی ان ان) -- تلاش برای پایان دادن به بن بست سنا بر سر رئیس جمهور &lt;b&gt;بوش&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 حاوی داده‌های اصلی است.

برچسب های فرعی SL_MAIN *
برچسب فرعی از آر
فرمت محتوا خالی
املا
تعریف

تگ <Spelling> یک پیشنهاد املایی جایگزین برای پرس و جو ارسال شده را در بر می گیرد. این برچسب فقط در صفحه اول نتایج جستجو ظاهر می شود. پیشنهادات املا به زبان های انگلیسی، چینی، ژاپنی و کره ای موجود است.

توجه: Google فقط پیشنهادات املایی را برای جستارهایی که مقدار پارامتر gl با حروف کوچک باشد برمی‌گرداند.

مثال <املا>
برچسب های فرعی پیشنهاد
برچسب فرعی از GSP
فرمت محتوا خالی
پیشنهاد
تعریف تگ <پیشنهاد> حاوی یک پیشنهاد املای جایگزین برای درخواست ارسال شده است. می توانید از محتوای برچسب برای پیشنهاد املای جایگزین به کاربر جستجوی خود استفاده کنید. مقدار ویژگی q پیشنهاد املایی با آدرس URL است که می‌توانید به عنوان عبارت پرس و جو از آن استفاده کنید.
صفات
نام قالب توضیحات
q متن ویژگی q نسخه‌ی URL-Escape شده پیشنهاد املایی را مشخص می‌کند.
مثال <پیشنهاد q="soccer">&lt;b&gt;&lt;i&gt;فوتبال&lt;/i&gt;&lt;/b&gt;</Suggestion>
برچسب فرعی از املا
فرمت محتوا متن (HTML)
تی
تعریف تگ <T> حاوی عنوان نتیجه است.
مثال <T>پیتزا فروشی ساحل شرقی آمیسی</T>
برچسب فرعی از آر
فرمت محتوا متن (HTML)
عنوان
تعریف

به عنوان فرزند <Context> ، تگ <title> حاوی نام موتور جستجوی قابل برنامه ریزی شما است.

به عنوان فرزند <Facet> ، تگ <title> عنوانی را برای مجموعه ای از جنبه ها ارائه می دهد.

مثال

به عنوان فرزند <Context>: <title>موتور جستجوی من</title>

به عنوان فرزند <Facet>: <title>عنوان وجه</title>

برچسب فرعی از زمینه ، جنبه
فرمت محتوا متن
TM
تعریف

تگ <TM> کل زمان مورد نیاز سرور برای بازگشت نتایج جستجو را که بر حسب ثانیه اندازه گیری می شود، مشخص می کند.

مثال <TM>0.100445</TM>
برچسب فرعی از GSP
فرمت محتوا متن (شماره ممیز شناور)
TT
تعریف تگ <TT> یک نکته جستجو را ارائه می دهد.
مثال <TT>&lt;i&gt;نکته: برای اکثر مرورگرها، فشار دادن کلید Return نتایجی مشابه با کلیک کردن روی دکمه جستجو ایجاد می‌کند.&lt;/i&gt;</TT>
برچسب فرعی از GSP
U
تعریف تگ <U> URL نتیجه جستجو را ارائه می دهد.
مثال <U>http://www.dominos.com/</U>
برچسب فرعی از آر
فرمت محتوا متن (URL مطلق)
UD
تعریف

تگ <UD> URL کدگذاری شده با IDN (نام دامنه بین المللی) را برای نتیجه جستجو فراهم می کند. این مقدار به دامنه ها اجازه می دهد تا با استفاده از زبان های محلی نمایش داده شوند. برای مثال، نشانی اینترنتی کد شده با IDN 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-escape شده است به طوری که برای ارسال به عنوان پارامتر پرس و جو در URL مناسب است.
مثال <UE>http://www.dominos.com/</UE>
برچسب فرعی از آر
فرمت محتوا متن (URL-Escaped URL)
XT
تعریف تگ <XT> نشان می دهد که تعداد کل تخمینی نتایج، همانطور که توسط تگ M مشخص شده است، در واقع تعداد کل دقیق نتایج را نشان می دهد. برای جزئیات بیشتر به بخش فیلتر خودکار این سند مراجعه کنید.
مثال <XT />
برچسب فرعی از RES
فرمت محتوا خالی

نتایج XML برای پرس و جوهای جستجوی تصویر

این نمونه درخواست تصویر 5 نتیجه (تعداد = 5) در مورد عبارت جستجوی "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

این درخواست نتیجه XML را در زیر به دست می دهد. 


<GSP VER="3.2">
  <TM>0.395037</TM>
  <Q>monkeys</Q>

  <PARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_<escaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/>
  <PARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/>
  <PARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/>
  <PARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/>
  <PARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/>
  <PARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/>
  <PARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/>
  <PARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/>
  <PARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/>

  <Context>
    <title>domestigeek</title>
  </Context>

  <ARES/>
  <RES SN="1" EN="2">
    <M>2500000</M>
    <NB>
      <NU>/images?q=monkeys&num=2&hl=en&client=google-csbe&cx=011737558837375720776:mbfrjmyam1g&boostcse=0&output=xml_no_dtd
        &ie=UTF-8&oe=UTF-8&tbm=isch&ei=786oTsLiJaaFiALKrPChBg&start=2&sa=N
      </NU>
    </NB>
    <RG START="1" SIZE="2"/>
      <R N="1" MIME="image/jpeg">
        <RU>http://www.flickr.com/photos/fncll/135465558/</RU>
        <U>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        </UE>
        <T>Computer <b>Monkeys</b> | Flickr - Photo Sharing!</T>
        <RK>0</RK>
        <BYLINEDATE>1146034800</BYLINEDATE>
        <S>Computer <b>Monkeys</b> | Flickr</S>
        <LANG>en</LANG>
        <IMG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs">
          <SZ>88386</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/>
      </R>
      <R N="2" MIME="image/jpeg">
        <RU>
          http://www.flickr.com/photos/flickerbulb/187044366/
        </RU>
        <U>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </U>
        <UE>
          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        </UE>
        <T>
          one. ugly. <b>monkey</b>. | Flickr - Photo Sharing!
        </T>
        <RK>0</RK>
        <BYLINEDATE>1152514800</BYLINEDATE>
        <S>one. ugly. <b>monkey</b>.</S>
        <LANG>en</LANG>
        <IMG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"><SZ>58339</SZ>
          <IN/>
        </IMG>
        <TBN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/>
      </R>
  </RES>
</GSP>

جستجوی تصویر: برچسب های XML

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

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

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

RG
تعریف

تگ <RG> جزئیات یک نتیجه جستجوی تصویر را در بر می گیرد.

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

تگ <RU tag> جزئیات هر نتیجه جستجوی تصویر را در بر می گیرد.

برچسب فرعی از آر