Search

پاسخ به درخواست جستجوی سفارشی

نمایندگی JSON
{
  "kind": string,
  "url": {
    "type": string,
    "template": string
  },
  "queries": {
    "previousPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "request": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ],
    "nextPage": [
      {
        "title": string,
        "totalResults": string,
        "searchTerms": string,
        "count": integer,
        "startIndex": integer,
        "startPage": integer,
        "language": string,
        "inputEncoding": string,
        "outputEncoding": string,
        "safe": string,
        "cx": string,
        "sort": string,
        "filter": string,
        "gl": string,
        "cr": string,
        "googleHost": string,
        "disableCnTwTranslation": string,
        "hq": string,
        "hl": string,
        "siteSearch": string,
        "siteSearchFilter": string,
        "exactTerms": string,
        "excludeTerms": string,
        "linkSite": string,
        "orTerms": string,
        "relatedSite": string,
        "dateRestrict": string,
        "lowRange": string,
        "highRange": string,
        "fileType": string,
        "rights": string,
        "searchType": string,
        "imgSize": string,
        "imgType": string,
        "imgColorType": string,
        "imgDominantColor": string
      }
    ]
  },
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "context": {
    object
  },
  "searchInformation": {
    "searchTime": number,
    "formattedSearchTime": string,
    "totalResults": string,
    "formattedTotalResults": string
  },
  "spelling": {
    "correctedQuery": string,
    "htmlCorrectedQuery": string
  },
  "items": [
    {
      object (Result)
    }
  ]
}
زمینه های
kind

string

شناسه منحصر به فرد برای نوع شی فعلی. برای این API، customsearch#search است.

url

object

عنصر URL OpenSearch که الگوی این API را تعریف می کند.

url.type

string

نوع MIME الگوی URL OpenSearch برای جستجوی سفارشی JSON API.

url.template

string

الگوی OpenSearch واقعی برای این API.

queries

object

حاوی یک یا چند مجموعه از فراداده پرس و جو است که با نام نقش کلید می خورد. نام نقش های احتمالی شامل request تعریف شده توسط نقش های جستجوی OpenSearch و دو نقش سفارشی است: nextPage و previousPage .

queries.previousPage[]

object

در صورت وجود، ابرداده نشان دهنده صفحه قبلی نتایج است.

queries.previousPage[].title

string

شرح پرس و جو

queries.previousPage[].totalResults

string ( int64 format)

تعداد تخمینی کل نتایج جستجو. ممکن است دقیق نباشد.

queries.previousPage[].searchTerms

string

عبارات جستجوی وارد شده توسط کاربر.

queries.previousPage[].count

integer

تعداد نتایج جستجوی بازگشتی در این مجموعه.

queries.previousPage[].startIndex

integer

شاخص مجموعه فعلی نتایج جستجو به مجموعه کل نتایج، که در آن شاخص اولین نتیجه 1 است.

queries.previousPage[].startPage

integer

شماره صفحه این مجموعه از نتایج، که در آن طول صفحه توسط ویژگی count تنظیم می شود.

queries.previousPage[].language

string

زبان نتایج جستجو

queries.previousPage[].inputEncoding

string

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

queries.previousPage[].outputEncoding

string

رمزگذاری کاراکتر برای نتایج جستجو پشتیبانی می شود.

queries.previousPage[].safe

string

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

  • "off" : جستجوی ایمن را غیرفعال کنید

  • "active" : SafeSearch را فعال کنید

queries.previousPage[].cx

string

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

queries.previousPage[].sort

string

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

queries.previousPage[].filter

string

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

  • 0 : غیر فعال

  • 1 : فعال (پیش‌فرض)

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

queries.previousPage[].gl

string

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

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

queries.previousPage[].cr

string

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

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

  • دامنه سطح بالای (TLD) URL سند.

  • موقعیت جغرافیایی آدرس IP سرور وب.

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

queries.previousPage[].googleHost

string

دامنه Google (به عنوان مثال google.com، google.de یا google.fr) را مشخص می کند که جستجو باید به آن محدود شود.

queries.previousPage[].disableCnTwTranslation

string

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

مقادیر پشتیبانی شده عبارتند از:

  • 0 : فعال (پیش فرض)

  • 1 : غیر فعال

queries.previousPage[].hq

string

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

queries.previousPage[].hl

string

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

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

queries.previousPage[].siteSearch

string

نتایج را به URL های یک سایت مشخص محدود می کند.

queries.previousPage[].siteSearchFilter

string

مشخص می‌کند که آیا نتایج از سایتی که در پارامتر sitesearch نامگذاری شده است گنجانده شود یا حذف شود. مقادیر پشتیبانی شده عبارتند از:

  • i : شامل محتوای سایت

  • e : حذف محتوا از سایت

queries.previousPage[].exactTerms

string

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

queries.previousPage[].excludeTerms

string

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

queries.previousPage[].linkSite

string

مشخص می کند که همه نتایج باید حاوی پیوندی به یک URL خاص باشند.

queries.previousPage[].orTerms

string

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

queries.previousPage[].relatedSite

string

مشخص می کند که تمام نتایج جستجو باید صفحاتی باشند که به URL مشخص شده مرتبط هستند. مقدار پارامتر باید یک URL باشد.

queries.previousPage[].dateRestrict

string

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

  • d[number] : درخواست‌ها از تعداد مشخص شده روزهای گذشته نتیجه می‌شوند.

  • w[number] : درخواست ها از تعداد مشخص شده هفته های گذشته نتیجه می گیرند.

  • m[number] : درخواست‌ها از تعداد مشخص شده ماه‌های گذشته نتیجه می‌شوند.

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

queries.previousPage[].lowRange

string

مقدار شروع یک محدوده جستجو را مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.previousPage[].highRange

string

مقدار پایانی یک محدوده جستجو را مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.previousPage[].fileType

string

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

  • فرمت سند قابل حمل Adobe ( pdf )

  • Adobe PostScript ( ps )

  • لوتوس 1-2-3 ( wk1 , wk2 , wk3 , wk4 , wk5 , wki , wks , wku )

  • Lotus WordPro ( lwp )

  • مک رایت ( mw )

  • مایکروسافت اکسل ( xls )

  • پاورپوینت مایکروسافت ( ppt )

  • مایکروسافت ورد ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • مایکروسافت رایت ( wri )

  • قالب متن غنی ( rtf )

  • Shockwave Flash ( swf )

  • متن ( ans , txt ).

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

queries.previousPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.previousPage[].searchType

string

مقادیر مجاز web یا image هستند. اگر مشخص نباشد، نتایج به صفحات وب محدود می شود.

queries.previousPage[].imgSize

string

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

  • icon (کوچک)

  • small | medium | large | xlarge (متوسط)

  • xxlarge (بزرگ)

  • huge (بسیار بزرگ)

queries.previousPage[].imgType

string

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

  • clipart (کلیپ آرت)

  • face (چهره)

  • lineart (طراحی خطی)

  • photo (عکس)

  • animated (متحرک)

  • stock (سهام)

queries.previousPage[].imgColorType

string

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

  • mono (سیاه و سفید)

  • gray (مقیاس خاکستری)

  • color (رنگ)

queries.previousPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.request[]

object

فراداده نشان دهنده درخواست فعلی.

queries.request[].title

string

شرح پرس و جو

queries.request[].totalResults

string ( int64 format)

تعداد تخمینی کل نتایج جستجو. ممکن است دقیق نباشد.

queries.request[].searchTerms

string

عبارات جستجوی وارد شده توسط کاربر.

queries.request[].count

integer

تعداد نتایج جستجوی بازگشتی در این مجموعه.

queries.request[].startIndex

integer

شاخص مجموعه فعلی نتایج جستجو به مجموعه کل نتایج، که در آن شاخص اولین نتیجه 1 است.

queries.request[].startPage

integer

شماره صفحه این مجموعه از نتایج، که در آن طول صفحه توسط ویژگی count تنظیم می شود.

queries.request[].language

string

زبان نتایج جستجو

queries.request[].inputEncoding

string

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

queries.request[].outputEncoding

string

رمزگذاری کاراکتر برای نتایج جستجو پشتیبانی می شود.

queries.request[].safe

string

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

  • "off" : جستجوی ایمن را غیرفعال کنید

  • "active" : SafeSearch را فعال کنید

queries.request[].cx

string

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

queries.request[].sort

string

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

queries.request[].filter

string

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

  • 0 : غیر فعال

  • 1 : فعال (پیش‌فرض)

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

queries.request[].gl

string

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

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

queries.request[].cr

string

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

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

  • دامنه سطح بالای (TLD) URL سند.

  • موقعیت جغرافیایی آدرس IP سرور وب.

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

queries.request[].googleHost

string

دامنه Google (به عنوان مثال google.com، google.de یا google.fr) را مشخص می کند که جستجو باید به آن محدود شود.

queries.request[].disableCnTwTranslation

string

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

مقادیر پشتیبانی شده عبارتند از:

  • 0 : فعال (پیش فرض)

  • 1 : غیر فعال

queries.request[].hq

string

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

queries.request[].hl

string

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

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

queries.request[].siteSearch

string

نتایج را به URL های یک سایت مشخص محدود می کند.

queries.request[].siteSearchFilter

string

مشخص می‌کند که آیا نتایج از سایتی که در پارامتر sitesearch نامگذاری شده است گنجانده شود یا حذف شود. مقادیر پشتیبانی شده عبارتند از:

  • i : شامل محتوای سایت

  • e : حذف محتوا از سایت

queries.request[].exactTerms

string

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

queries.request[].excludeTerms

string

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

queries.request[].linkSite

string

مشخص می کند که همه نتایج باید حاوی پیوندی به یک URL خاص باشند.

queries.request[].orTerms

string

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

queries.request[].relatedSite

string

مشخص می کند که تمام نتایج جستجو باید صفحاتی باشند که به URL مشخص شده مرتبط هستند. مقدار پارامتر باید یک URL باشد.

queries.request[].dateRestrict

string

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

  • d[number] : درخواست‌ها از تعداد مشخص شده روزهای گذشته نتیجه می‌شوند.

  • w[number] : درخواست ها از تعداد مشخص شده هفته های گذشته نتیجه می گیرند.

  • m[number] : درخواست‌ها از تعداد مشخص شده ماه‌های گذشته نتیجه می‌شوند.

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

queries.request[].lowRange

string

مقدار شروع را برای محدوده جستجو مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.request[].highRange

string

مقدار پایانی یک محدوده جستجو را مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.request[].fileType

string

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

  • فرمت سند قابل حمل Adobe ( pdf )

  • Adobe PostScript ( ps )

  • لوتوس 1-2-3 ( wk1 , wk2 , wk3 , wk4 , wk5 , wki , wks , wku )

  • Lotus WordPro ( lwp )

  • مک رایت ( mw )

  • مایکروسافت اکسل ( xls )

  • پاورپوینت مایکروسافت ( ppt )

  • مایکروسافت ورد ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • مایکروسافت رایت ( wri )

  • فرمت متن غنی ( rtf )

  • Shockwave Flash ( swf )

  • متن ( ans , txt ).

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

queries.request[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.request[].searchType

string

مقادیر مجاز web یا image هستند. اگر مشخص نباشد، نتایج به صفحات وب محدود می شود.

queries.request[].imgSize

string

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

  • icon (کوچک)

  • small | medium | large | xlarge (متوسط)

  • xxlarge (بزرگ)

  • huge (بسیار بزرگ)

queries.request[].imgType

string

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

  • clipart (کلیپ آرت)

  • face (چهره)

  • lineart (طراحی خطی)

  • photo (عکس)

  • animated (متحرک)

  • stock (سهام)

queries.request[].imgColorType

string

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

  • mono (سیاه و سفید)

  • gray (مقیاس خاکستری)

  • color (رنگ)

queries.request[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

queries.nextPage[]

object

در صورت وجود، ابرداده نشان دهنده صفحه بعدی نتایج است.

queries.nextPage[].title

string

شرح پرس و جو

queries.nextPage[].totalResults

string ( int64 format)

تعداد تخمینی کل نتایج جستجو. ممکن است دقیق نباشد.

queries.nextPage[].searchTerms

string

عبارات جستجوی وارد شده توسط کاربر.

queries.nextPage[].count

integer

تعداد نتایج جستجوی بازگشتی در این مجموعه.

queries.nextPage[].startIndex

integer

شاخص مجموعه فعلی نتایج جستجو به مجموعه کل نتایج، که در آن شاخص اولین نتیجه 1 است.

queries.nextPage[].startPage

integer

شماره صفحه این مجموعه از نتایج، که در آن طول صفحه توسط ویژگی count تنظیم می شود.

queries.nextPage[].language

string

زبان نتایج جستجو

queries.nextPage[].inputEncoding

string

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

queries.nextPage[].outputEncoding

string

رمزگذاری کاراکتر برای نتایج جستجو پشتیبانی می شود.

queries.nextPage[].safe

string

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

  • "off" : جستجوی ایمن را غیرفعال کنید

  • "active" : SafeSearch را فعال کنید

queries.nextPage[].cx

string

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

queries.nextPage[].sort

string

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

queries.nextPage[].filter

string

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

  • 0 : غیر فعال

  • 1 : فعال (پیش‌فرض)

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

queries.nextPage[].gl

string

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

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

queries.nextPage[].cr

string

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

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

  • دامنه سطح بالای (TLD) URL سند.

  • موقعیت جغرافیایی آدرس IP سرور وب.

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

queries.nextPage[].googleHost

string

دامنه Google (به عنوان مثال google.com، google.de یا google.fr) را مشخص می کند که جستجو باید به آن محدود شود.

queries.nextPage[].disableCnTwTranslation

string

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

مقادیر پشتیبانی شده عبارتند از:

  • 0 : فعال (پیش فرض)

  • 1 : غیر فعال

queries.nextPage[].hq

string

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

queries.nextPage[].hl

string

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

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

queries.nextPage[].siteSearch

string

نتایج را به URL های یک سایت مشخص محدود می کند.

queries.nextPage[].siteSearchFilter

string

مشخص می‌کند که آیا نتایج از سایتی که در پارامتر sitesearch نامگذاری شده است گنجانده شود یا حذف شود. مقادیر پشتیبانی شده عبارتند از:

  • i : شامل محتوای سایت

  • e : حذف محتوا از سایت

queries.nextPage[].exactTerms

string

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

queries.nextPage[].excludeTerms

string

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

queries.nextPage[].linkSite

string

مشخص می کند که همه نتایج باید حاوی پیوندی به یک URL خاص باشند.

queries.nextPage[].orTerms

string

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

queries.nextPage[].relatedSite

string

مشخص می کند که تمام نتایج جستجو باید صفحاتی باشند که به URL مشخص شده مرتبط هستند. مقدار پارامتر باید یک URL باشد.

queries.nextPage[].dateRestrict

string

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

  • d[number] : درخواست‌ها از تعداد مشخص شده روزهای گذشته نتیجه می‌شوند.

  • w[number] : درخواست ها از تعداد مشخص شده هفته های گذشته نتیجه می گیرند.

  • m[number] : درخواست‌ها از تعداد مشخص شده ماه‌های گذشته نتیجه می‌شوند.

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

queries.nextPage[].lowRange

string

مقدار شروع یک محدوده جستجو را مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.nextPage[].highRange

string

مقدار پایانی یک محدوده جستجو را مشخص می کند. از cse:lowRange و cse:highrange برای افزودن محدوده جستجوی فراگیر lowRange...highRange به درخواست استفاده کنید.

queries.nextPage[].fileType

string

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

  • فرمت سند قابل حمل Adobe ( pdf )

  • Adobe PostScript ( ps )

  • لوتوس 1-2-3 ( wk1 , wk2 , wk3 , wk4 , wk5 , wki , wks , wku )

  • Lotus WordPro ( lwp )

  • مک رایت ( mw )

  • مایکروسافت اکسل ( xls )

  • پاورپوینت مایکروسافت ( ppt )

  • مایکروسافت ورد ( doc )

  • Microsoft Works ( wks , wps , wdb )

  • مایکروسافت رایت ( wri )

  • فرمت متن غنی ( rtf )

  • Shockwave Flash ( swf )

  • متن ( ans , txt ).

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

queries.nextPage[].rights

string

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

  • cc_publicdomain

  • cc_attribute

  • cc_sharealike

  • cc_noncommercial

  • cc_nonderived

queries.nextPage[].searchType

string

مقادیر مجاز web یا image هستند. اگر مشخص نباشد، نتایج به صفحات وب محدود می شود.

queries.nextPage[].imgSize

string

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

  • icon (کوچک)

  • small | medium | large | xlarge (متوسط)

  • xxlarge (بزرگ)

  • huge (بسیار بزرگ)

queries.nextPage[].imgType

string

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

  • clipart (کلیپ آرت)

  • face (چهره)

  • lineart (طراحی خطی)

  • photo (عکس)

  • animated (متحرک)

  • stock (سهام)

queries.nextPage[].imgColorType

string

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

  • mono (سیاه و سفید)

  • gray (مقیاس خاکستری)

  • color (رنگ)

queries.nextPage[].imgDominantColor

string

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

  • red

  • orange

  • yellow

  • green

  • teal

  • blue

  • purple

  • pink

  • white

  • gray

  • black

  • brown

promotions[]

object ( Promotion )

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

context

object ( Struct format)

فراداده و اصلاحات مرتبط با موتور جستجوی داده شده، از جمله:

  • نام موتور جستجویی که برای پرس و جو استفاده شده است.

  • مجموعه ای از اشیاء جنبه (تصفیه) که می توانید برای اصلاح جستجو استفاده کنید.

searchInformation

object

فراداده درباره این جستجو، از جمله زمان جستجو و کل نتایج.

searchInformation.searchTime

number

زمان صرف شده برای بازگشت نتایج جستجو توسط سرور.

searchInformation.formattedSearchTime

string

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

searchInformation.totalResults

string

تعداد کل نتایج جستجوی بازگردانده شده توسط پرس و جو.

searchInformation.formattedTotalResults

string

تعداد کل نتایج جستجو که بر اساس سبک محلی قالب بندی شده است.

spelling

object

یک پرس و جو تصحیح شده را کپسوله می کند.

spelling.correctedQuery

string

پرس و جو تصحیح شده

spelling.htmlCorrectedQuery

string

پرس و جو تصحیح شده، فرمت شده در HTML.

items[]

object ( Result )

مجموعه فعلی نتایج جستجوی سفارشی.

ترویج

نتیجه ارتقاء

نمایندگی JSON
{
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "bodyLines": [
    {
      "title": string,
      "htmlTitle": string,
      "url": string,
      "link": string
    }
  ],
  "image": {
    "source": string,
    "width": integer,
    "height": integer
  }
}
زمینه های
title

string

عنوان تبلیغ.

htmlTitle

string

عنوان تبلیغ، در HTML.

bodyLines[]

object

آرایه ای از اشیاء بلوک برای این تبلیغات.

bodyLines[].title

string

متن شیء بلوک، اگر دارای متن باشد.

bodyLines[].htmlTitle

string

متن شیء بلوک در HTML، اگر دارای متن باشد.

bodyLines[].url

string

نشانی وب پیوند شیء بلوک، در صورتی که دارای آن باشد.

bodyLines[].link

string

متن لنگر پیوند شیء بلوک، اگر پیوند داشته باشد.

image

object

تصویر مرتبط با این تبلیغات، در صورت وجود.

image.source

string

URL تصویر برای پیوند این تبلیغات.

image.width

integer

عرض تصویر بر حسب پیکسل

image.height

integer

ارتفاع تصویر بر حسب پیکسل

نتیجه

یک نتیجه جستجوی سفارشی

نمایندگی JSON
{
  "kind": string,
  "title": string,
  "htmlTitle": string,
  "link": string,
  "displayLink": string,
  "snippet": string,
  "htmlSnippet": string,
  "cacheId": string,
  "formattedUrl": string,
  "htmlFormattedUrl": string,
  "pagemap": {
    object
  },
  "mime": string,
  "fileFormat": string,
  "image": {
    "contextLink": string,
    "height": integer,
    "width": integer,
    "byteSize": integer,
    "thumbnailLink": string,
    "thumbnailHeight": integer,
    "thumbnailWidth": integer
  },
  "labels": [
    {
      "name": string,
      "displayName": string,
      "label_with_op": string
    }
  ]
}
زمینه های
kind

string

یک شناسه منحصر به فرد برای نوع شی فعلی. برای این API، customsearch#result.

title

string

عنوان نتیجه جستجو، به صورت متن ساده.

htmlTitle

string

عنوان نتیجه جستجو، در HTML.

snippet

string

تکه ای از نتیجه جستجو، به صورت متن ساده.

htmlSnippet

string

تکه ای از نتیجه جستجو، در HTML.

cacheId

string

نشان دهنده شناسه نسخه ذخیره شده گوگل از نتیجه جستجو است.

formattedUrl

string

URL نمایش داده شده پس از قطعه برای هر نتیجه جستجو.

htmlFormattedUrl

string

URL با قالب HTML که بعد از قطعه برای هر نتیجه جستجو نمایش داده می شود.

pagemap

object ( Struct format)

حاوی اطلاعات PageMap برای این نتیجه جستجو است.

mime

string

نوع MIME نتیجه جستجو.

fileFormat

string

فرمت فایل نتیجه جستجو

image

object

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

image.contextLink

string

نشانی اینترنتی که به صفحه وب میزبان تصویر اشاره دارد.

image.height

integer

ارتفاع تصویر بر حسب پیکسل

image.width

integer

عرض تصویر، بر حسب پیکسل.

image.byteSize

integer

اندازه تصویر بر حسب بایت

image.thumbnailLink

string

یک URL به تصویر کوچک.

image.thumbnailHeight

integer

ارتفاع تصویر کوچک، بر حسب پیکسل.

image.thumbnailWidth

integer

عرض تصویر کوچک، بر حسب پیکسل.

labels[]

object

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

labels[].name

string

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

labels[].displayName

string

نام نمایشی یک برچسب پالایش. این نامی است که باید در رابط کاربری خود نمایش دهید.

labels[].label_with_op

string

برچسب پالایش و عملیات پالایش مرتبط.