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 لـ Custom Search JSON API.
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 في طلبات WebSearch إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بصفة خاصة على العملاء الدوليين، لا سيّما العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.previousPage[].cr

string

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

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

  • يشير إلى نطاق المستوى الأعلى (TLD) لعنوان URL للمستند.

  • الموقع الجغرافي لعنوان IP لخادم الويب.

يُرجى الاطّلاع على قيم مَعلمة البلد (cr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة.
queries.previousPage[].googleHost

string

تُحدِّد نطاق Google (على سبيل المثال، google.com أو google.com أو 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)

  • Lotus WordPro (lwp)

  • ما اكتبه (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks، wps، wdb)

  • Microsoft نمط الكتابة (wri)

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

  • فلاش الصدمة المتأرجحة (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 في طلبات WebSearch إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بصفة خاصة على العملاء الدوليين، لا سيّما العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.request[].cr

string

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

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

  • يشير إلى نطاق المستوى الأعلى (TLD) لعنوان URL للمستند.

  • الموقع الجغرافي لعنوان IP لخادم الويب.

يُرجى الاطّلاع على قيم مَعلمة البلد (cr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة.
queries.request[].googleHost

string

تُحدِّد نطاق Google (على سبيل المثال، google.com أو google.com أو 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)

  • Lotus WordPro (lwp)

  • ما اكتبه (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks، wps، wdb)

  • Microsoft نمط الكتابة (wri)

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

  • فلاش الصدمة المتأرجحة (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 في طلبات WebSearch إلى تحسين مدى صلة النتائج بموضوع البحث. وينطبق هذا بصفة خاصة على العملاء الدوليين، لا سيّما العملاء في البلدان الناطقة بالإنجليزية غير الولايات المتحدة.
queries.nextPage[].cr

string

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

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

  • يشير إلى نطاق المستوى الأعلى (TLD) لعنوان URL للمستند.

  • الموقع الجغرافي لعنوان IP لخادم الويب.

يُرجى الاطّلاع على قيم مَعلمة البلد (cr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة.
queries.nextPage[].googleHost

string

تُحدِّد نطاق Google (على سبيل المثال، google.com أو google.com أو 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)

  • Lotus WordPro (lwp)

  • ما اكتبه (mw)

  • Microsoft Excel (xls)

  • Microsoft PowerPoint (ppt)

  • Microsoft Word (doc)

  • Microsoft Works (wks، wps، wdb)

  • Microsoft نمط الكتابة (wri)

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

  • فلاش الصدمة المتأرجحة (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

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