تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Search

تمثيل JSON
العروض الترويجية
- تمثيل JSON
النتيجة
- تمثيل JSON

الردّ على طلب بحث مخصّص

تمثيل JSON

تمثيل 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,
  "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 } }

تمثيل 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.
`link`	`string` تمثّل هذه السمة عنوان URL للعرض الترويجي.
`displayLink`	`string` نسخة مختصرة من عنوان URL لنتيجة البحث هذا، على سبيل المثال: www.example.com
`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 } ] }

تمثيل 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.
`link`	`string` عنوان URL الكامل الذي تشير إليه نتيجة البحث، على سبيل المثال http://www.example.com/foo/bar.
`displayLink`	`string` نسخة مختصرة من عنوان URL لنتيجة البحث هذه، مثل www.example.com
`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` علامة التصفية وعملية التصفية المرتبطة بها.