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

معرّف فريد لنوع العنصر الحالي بالنسبة إلى واجهة برمجة التطبيقات هذه، هي customsearch#search.
url

object

عنصر عنوان URL الخاص بـ OpenSearch والذي يحدّد نموذج واجهة برمجة التطبيقات هذه
url.type

string

نوع MIME لنموذج عنوان URL الخاص بـ OpenSearch لواجهة برمجة تطبيقات JSON للبحث المخصص.
url.template

string

تمثّل هذه السمة نموذج OpenSearch الفعلي لواجهة برمجة التطبيقات هذه.
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

تحدّد هذه السياسة مستوى "البحث الآمن" المستخدَم لفلترة النتائج الخاصة بالبالغين. هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. قيم المَعلمات الصالحة هي:

  • "off": إيقاف "البحث الآمن"

  • "active": تفعيل "البحث الآمن"
queries.previousPage[].cx

string

معرّف محرّك البحث الذي تم إنشاؤه باستخدام لوحة تحكّم "محرك البحث المبرمَج" هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. هذه المَعلمة مطلوبة.
queries.previousPage[].sort

string

لتحديد أنه يجب ترتيب النتائج وفقًا للتعبير المحدد. على سبيل المثال، الترتيب حسب التاريخ
queries.previousPage[].filter

string

تفعيل الفلترة التلقائية لنتائج بحث Google أو إيقافها. راجع التصفية التلقائية لمزيد من المعلومات عن فلاتر نتائج بحث Google. في ما يلي القيم الصالحة لهذه المَعلمة:

  • 0: موقوفة

  • 1: مُفعَّل (الإعداد التلقائي)

ملاحظة: يطبّق محرّك بحث Google تلقائيًا الفلترة على جميع نتائج البحث لتحسين جودة تلك النتائج.
queries.previousPage[].gl

string

تعمل هذه الميزة على تحسين نتائج البحث التي يتطابق بلد مصدرها مع قيمة المَعلمة. راجِع رموز البلدان للحصول على قائمة بالقيم الصالحة.

يؤدي تحديد قيمة مَعلمة gl في طلبات "بحث الويب" إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بوجه خاص على العملاء الدوليين، وبشكل أكثر تحديدًا على العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.previousPage[].cr

string

يقصر نتائج البحث على المستندات التي يتم إنشاؤها في بلد معيّن. يمكنك استخدام عوامل التشغيل المنطقية في قيمة مَعلمة cr.

تحدِّد خدمة "بحث الويب من Google" بلد المستند من خلال تحليل ما يلي:

  • نطاق المستوى الأعلى (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

توفّر هذه السياسة عبارات بحث إضافية للتحقّق منها في مستند، حيث يجب أن يحتوي كل مستند في نتائج البحث على عبارة واحدة على الأقل من عبارات البحث الإضافية. ويمكنك أيضًا استخدام عبارة طلب البحث المنطقية 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

يقصر النتائج على ملفات بامتداد محدّد. تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • لوتس WordPro (lwp)

  • ماككتابة (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks وwps وwdb)

  • Microsoft Write (wri)

  • تنسيق نصوص منسّقة (rtf)

  • فلاش Shockwave (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

تحدّد هذه السياسة مستوى "البحث الآمن" المستخدَم لفلترة النتائج الخاصة بالبالغين. هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. قيم المَعلمات الصالحة هي:

  • "off": إيقاف "البحث الآمن"

  • "active": تفعيل "البحث الآمن"
queries.request[].cx

string

معرّف محرّك البحث الذي تم إنشاؤه باستخدام لوحة تحكّم "محرك البحث المبرمَج" هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. هذه المَعلمة مطلوبة.
queries.request[].sort

string

لتحديد أنه يجب ترتيب النتائج وفقًا للتعبير المحدد. على سبيل المثال، الترتيب حسب التاريخ
queries.request[].filter

string

تفعيل الفلترة التلقائية لنتائج بحث Google أو إيقافها. راجع التصفية التلقائية لمزيد من المعلومات عن فلاتر نتائج بحث Google. في ما يلي القيم الصالحة لهذه المَعلمة:

  • 0: موقوفة

  • 1: مُفعَّل (الإعداد التلقائي)

ملاحظة: يطبّق محرّك بحث Google تلقائيًا الفلترة على جميع نتائج البحث لتحسين جودة تلك النتائج.
queries.request[].gl

string

تعمل هذه الميزة على تحسين نتائج البحث التي يتطابق بلد مصدرها مع قيمة المَعلمة. راجِع رموز البلدان للحصول على قائمة بالقيم الصالحة.

يؤدي تحديد قيمة مَعلمة gl في طلبات "بحث الويب" إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بوجه خاص على العملاء الدوليين، وبشكل أكثر تحديدًا على العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.request[].cr

string

يقصر نتائج البحث على المستندات التي يتم إنشاؤها في بلد معيّن. يمكنك استخدام عوامل التشغيل المنطقية في قيمة مَعلمة cr.

تحدِّد خدمة "بحث الويب من Google" بلد المستند من خلال تحليل ما يلي:

  • نطاق المستوى الأعلى (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

توفّر هذه السياسة عبارات بحث إضافية للتحقّق منها في مستند، حيث يجب أن يحتوي كل مستند في نتائج البحث على عبارة واحدة على الأقل من عبارات البحث الإضافية. ويمكنك أيضًا استخدام عبارة طلب البحث المنطقية 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

يقصر النتائج على ملفات بامتداد محدّد. تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • لوتس WordPro (lwp)

  • ماككتابة (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks وwps وwdb)

  • Microsoft Write (wri)

  • تنسيق نصوص منسّقة (rtf)

  • فلاش Shockwave (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

تحدّد هذه السياسة مستوى "البحث الآمن" المستخدَم لفلترة النتائج الخاصة بالبالغين. هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. قيم المَعلمات الصالحة هي:

  • "off": إيقاف "البحث الآمن"

  • "active": تفعيل "البحث الآمن"
queries.nextPage[].cx

string

معرّف محرّك البحث الذي تم إنشاؤه باستخدام لوحة تحكّم "محرك البحث المبرمَج" هذه خاصية مخصّصة لم يتم تعريفها في مواصفات OpenSearch. هذه المَعلمة مطلوبة.
queries.nextPage[].sort

string

لتحديد أنه يجب ترتيب النتائج وفقًا للتعبير المحدد. على سبيل المثال، الترتيب حسب التاريخ
queries.nextPage[].filter

string

تفعيل الفلترة التلقائية لنتائج بحث Google أو إيقافها. راجع التصفية التلقائية لمزيد من المعلومات عن فلاتر نتائج بحث Google. في ما يلي القيم الصالحة لهذه المَعلمة:

  • 0: موقوفة

  • 1: مُفعَّل (الإعداد التلقائي)

ملاحظة: يطبّق محرّك بحث Google تلقائيًا الفلترة على جميع نتائج البحث لتحسين جودة تلك النتائج.
queries.nextPage[].gl

string

تعمل هذه الميزة على تحسين نتائج البحث التي يتطابق بلد مصدرها مع قيمة المَعلمة. راجِع رموز البلدان للحصول على قائمة بالقيم الصالحة.

يؤدي تحديد قيمة مَعلمة gl في طلبات "بحث الويب" إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بوجه خاص على العملاء الدوليين، وبشكل أكثر تحديدًا على العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.nextPage[].cr

string

يقصر نتائج البحث على المستندات التي يتم إنشاؤها في بلد معيّن. يمكنك استخدام عوامل التشغيل المنطقية في قيمة مَعلمة cr.

تحدِّد خدمة "بحث الويب من Google" بلد المستند من خلال تحليل ما يلي:

  • نطاق المستوى الأعلى (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

توفّر هذه السياسة عبارات بحث إضافية للتحقّق منها في مستند، حيث يجب أن يحتوي كل مستند في نتائج البحث على عبارة واحدة على الأقل من عبارات البحث الإضافية. ويمكنك أيضًا استخدام عبارة طلب البحث المنطقية 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

يقصر النتائج على ملفات بامتداد محدّد. تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:

  • Adobe Portable Document Format (pdf)

  • Adobe PostScript (ps)

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

  • لوتس WordPro (lwp)

  • ماككتابة (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks وwps وwdb)

  • Microsoft Write (wri)

  • تنسيق نصوص منسّقة (rtf)

  • فلاش Shockwave (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

تمثّل هذه السمة عنوان URL لرابط عنصر الحظر، إذا كان متوفّرًا.
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

معرّف فريد لنوع العنصر الحالي بالنسبة إلى واجهة برمجة التطبيقات هذه، هي customsearch#result.
title

string

تمثّل هذه السمة عنوان نتيجة البحث بتنسيق نص عادي.
htmlTitle

string

تمثّل هذه السمة عنوان نتيجة البحث بتنسيق HTML.
snippet

string

مقتطف من نتيجة البحث بتنسيق نص عادي
htmlSnippet

string

مقتطف نتيجة البحث بتنسيق HTML.
cacheId

string

يشير إلى معرّف نسخة Google المخزّنة مؤقتًا لنتيجة البحث.
formattedUrl

string

عنوان URL المعروض بعد المقتطف لكل نتيجة بحث.
htmlFormattedUrl

string

عنوان URL بتنسيق HTML والمعروض بعد المقتطف لكل نتيجة بحث.
pagemap

object (Struct format)

تتضمَّن معلومات PageMap لنتيجة البحث هذه.
mime

string

نوع MIME لنتيجة البحث.
fileFormat

string

تمثّل هذه السمة تنسيق ملف نتيجة البحث.
image

object

يتضمن هذا العمود جميع المعلومات حول صورة يتم عرضها في نتائج البحث.
image.contextLink

string

تمثّل هذه السمة عنوان URL يشير إلى صفحة الويب التي تستضيف الصورة.
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

علامة التصفية وعملية التصفية المرتبطة بها.