مرجع واجهة برمجة التطبيقات بتنسيق XML

تشير هذه الصفحة إلى إصدار XML من واجهة برمجة تطبيقات JSON للبحث المخصص، والتي تتوفر فقط عملاء Google Site Search.

  1. نظرة عامة
  2. تنسيق طلب محرك البحث المبرمَج
    1. طلب نظرة عامة
    2. عبارات طلب البحث
    3. معلَمات الطلب
      1. نماذج طلبات بحث الويب
      2. تعريفات مَعلمات طلبات البحث على الويب
      3. البحث المتقدّم
      4. مَعلمات طلبات البحث المتقدّمة
      5. عبارات طلبات البحث الخاصة
      6. نماذج طلبات البحث عن الصور
      7. مَعلمات طلب البحث بالصور
      8. الحدود القصوى المسموح بها للطلبات
    4. تدويل طلبات البحث والنتائج
      1. ترميز الأحرف
      2. لغات الواجهة
      3. البحث بالصينية المبسّطة والتقليدية
    5. فلترة النتائج
      1. الفلترة التلقائية لنتائج البحث
      2. فلترة اللغة والبلد
      3. فلترة محتوى البالغين باستخدام ميزة "البحث الآمن"
  3. نتائج XML
    1. البيانات بتنسيق XML من Google (DTD)
    2. لمحة عن استجابة XML
    3. نتائج XML للنتائج العادية والصور طلبات البحث المتقدّمة
      1. البحث العادي/المتقدم: نموذج طلب بحث ونتيجة XML
      2. البحث العادي/المتقدم: علامات XML
      3. نتائج XML لطلبات البحث عن الصور
      4. بحث الصور: نموذج طلب بحث ونتيجة XML
      5. بحث الصور: علامات XML

نظرة عامة

تعمل خدمة "بحث الويب من Google" على تفعيل ميزة "البحث في الموقع من Google" عرض نتائج بحث Google على مواقعهم على الويب. تشير رسالة الأشكال البيانية تستخدم خدمة WebSearch بروتوكولًا بسيطًا مستندًا إلى HTTP لعرض نتائج البحث نتائجك. يتمتع مشرفو البحث بالتحكم الكامل في الطريقة التي طلب نتائج البحث والطريقة التي يقدمون بها هذه النتائج في المستخدم النهائي. يصف هذا المستند التفاصيل الفنية لنظام وتنسيقات طلبات البحث والنتائج.

لاسترداد نتائج بحث الويب من Google، يرسل تطبيقك Google طلب HTTP بسيط. بعد ذلك يعرض محرك بحث Google نتائج البحث بتنسيق XML . تمنحك النتائج بتنسيق XML القدرة على تخصيص طريقة عرض نتائج البحث.

تنسيق طلب بحث الويب

نظرة عامة على الطلب

طلب "بحث Google" هو أمر HTTP GET عادي. أُنشأها جون هنتر، الذي كان متخصصًا مجموعة من المعاملات ذات الصلة طلبات البحث. يتم تضمين هذه المعلمات في عنوان URL للطلب على النحو التالي: name=value أزواج مفصولة بأحرف علامة العطف (&). تتضمّن المَعلمات بيانات مثل طلب البحث ومعرّف المحرك الفريد (cx) الذي يحدد المحرك الذي يصدر طلب HTTP. يتم إرجاع خدمة "بحث الويب" أو "البحث بالصور" ينتج عن ملف XML الاستجابة لطلبات HTTP.

عبارات طلب البحث

تتضمن معظم طلبات البحث عبارة بحث واحدة أو أكثر. مصطلح استعلام كقيمة لمعلَمة في طلب البحث.

يمكن لمصطلحات طلب البحث تحديد عدة أنواع من المعلومات لتصفية تنظيم نتائج البحث التي يعرضها Google. يمكن لطلبات البحث تحديد ما يلي:

  • الكلمات أو العبارات المطلوب تضمينها أو استبعاد
    • جميع الكلمات في طلب البحث (تلقائي)
    • عبارة دقيقة في طلب البحث
    • أي كلمة أو عبارة في طلب البحث
  • المكان في المستند للبحث عن عبارات البحث
    • أي مكان في المستند (الإعداد التلقائي)
    • فقط في نص المستند
    • في عنوان المستند فقط
    • في عنوان URL للمستند فقط
    • في الروابط داخل المستند فقط
  • القيود المفروضة على المستندات نفسها
    • تضمين أو استبعاد مستندات من أنواع ملفات معيّنة (مثل ملفات PDF أو مستندات Word)
  • طلبات البحث الخاصة بعناوين URL التي تعرض للحصول على معلومات حول عنوان URL معيّن، بدلاً من إجراء عملية بحث
    • طلبات البحث التي تعرض معلومات عامة عن عنوان URL، مثل فئة أو مقتطف أو لغة الدليل المفتوح
    • طلبات البحث التي تعرض مجموعة صفحات الويب التي ترتبط بعنوان URL
    • طلبات البحث التي تعرض مجموعة من صفحات الويب المشابهة لعنوان URL معيّن

البحث التلقائي

يجب أن تتضمن قيم معلَمات طلب البحث أحرف إلغاء بعنوان URL. لاحظ أنه ستستبدل علامة الجمع ("+") بأي تسلسلات مسافات بيضاء في طلب البحث. ويمكنك مناقشة ذلك بالتفصيل في قسم الخروج من عنوان URL في هذا المستند.

يتم إرسال عبارة طلب البحث إلى خدمة "بحث الويب" باستخدام المعلمة q. حاسمة نموذج عبارة طلب البحث هو:

q=horses+cows+pigs

بشكل افتراضي، لا تعرض خدمة بحث الويب من Google سوى المستندات التي تضمين جميع المصطلحات في طلب البحث.

معلَمات الطلبات

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

هناك ثلاث معلمات طلب مطلوبة:

  • يجب ضبط المَعلمة client على google-csbe.
  • تحدد المعلمة output تنسيق نتائج XML المعروضة يمكن عرض النتائج باستخدام (xml) أو لا تحتوي على (xml_no_dtd) إشارة إلى DTD من Google. ننصحك بما يلي: لضبط هذه القيمة على xml_no_dtd. ملاحظة: إذا لم تحدّد هذه المَعلمة، سيتمّ عرض النتائج بالتنسيق HTML بدلاً من XML.
  • المَعلمة cx التي تمثّل المَعلمة الفريدة رقم تعريف المحرّك

معلمات الطلب الأكثر استخدامًا بخلاف المعلمات المذكورة أعلاه هي:

  • num - العدد المطلوب من نتائج البحث
  • q: عبارات البحث
  • start: فهرس البدء للنتائج

نماذج طلبات بحث الويب

تعرض الأمثلة أدناه بعض طلبات WebSearch HTTP إلى كيفية استخدام مَعلمات طلب البحث المختلفة. تعريفات يتم توفير معلمات طلب بحث مختلفة في طلب بحث الويب تعريفات المَعلمات وطلب البحث المتقدم أقسام المَعلمات في هذا المستند.

يطلب هذا الطلب أول 10 نتائج (start=0&num=10) لعبارة طلب البحث "red Sox" (q=red+sox). يحتوي الاستعلام أيضًا أن النتائج يجب أن تأتي من المواقع الإلكترونية الكندية (cr=countryCA) ويجب كتابتها باللغة الفرنسية (lr=lang_fr). أخيرًا، يحتوي الاستعلام يحدد قيمًا لكل من client وoutput وcx، وكلها مطلوبة.

http://www.google.com/search?
start=0
&num=10
&q=red+sox
&cr=countryCA
&lr=lang_fr
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

يستخدم هذا المثال بعضًا من طلبات البحث المتقدمة لتخصيص طلب البحث بشكل أكبر. يستخدم هذا الطلب دالة as_q (as_q=red+sox) بدلاً من المعلمة q. كما تستخدم دالة as_eq لاستبعاد أي مستندات تحتوي على كلمة "يانكيس". من صفحة نتائج البحث (as_eq=yankees).

http://www.google.com/search?
start=0
&num=10
&as_q=red+sox
&as_eq=Yankees
&client=google-csbe
&output=xml_no_dtd
&cx=00255077836266642015:u-scht7a-8i

تعريفات معلمات طلب بحث الويب

c2coff
الوصف

Optional. تعمل المعلمة c2coff على تمكين أو تعطيل المعلمة المبسطة والبحث الصينية التقليدية.

القيمة التلقائية لهذه المَعلمة هي 0 (صفر)، ما يعني أن الميزة مفعّلة. قيم المعلَمة c2coff هي:

القيمة الإجراء
1 غير مفعّل
0 مفعّلة
أمثلة q=google&c2coff=1

عميل
الوصف

مَعلمة مطلوبة. يجب ضبط المَعلمة client على google-csbe.

أمثلة q=google&client=google-csbe

كوستاريكا
الوصف

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

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

  • نطاق المستوى الأعلى (TLD) لعنوان URL للمستند
  • الموقع الجغرافي لعنوان IP لخادم الويب

راجِع مَعلمة البلد (cr). القيم للاطّلاع على قائمة بالقيم الصالحة لهذه المَعلمة.

أمثلة q=Frodo&cr=countryNZ

تجربة العملاء
الوصف

مَعلمة مطلوبة. تحدد المعلمة cx قيمة فريدة رمز يحدد قيمة مخصصة محرك بحث Google. عليك تحديد "محرك بحث مبرمَج" باستخدام المَعلمة cx لاسترداد نتائج البحث من ذلك المحرّك.

للعثور على قيمة المعلمة cx، انتقل إلى لوحة التحكم > الرموز في المحرك، وستجدها في مربّع النصّ ضمن "الصق هذه التعليمة البرمجية في الصفحة التي تريد أن موضع الإعلان. سيتم عرض نتائج البحث على صفحة تستضيفها Google."

أمثلة q=Frodo&cx=00255077836266642015:u-scht7a-8i

تصفية
الوصف

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

القيمة التلقائية للمَعلمة filter هي 1، مما يشير إلى تمكين الميزة. قيم صالحة لهذه السمة المعلمة هي:

القيمة الإجراء
1 غير مفعّل
0 مفعّلة

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

أمثلة q=google&filter=0

gl
الوصف

Optional. قيمة المعلمة gl هي رمز البلد المكون من حرفين. بالنسبة إلى نتائج "بحث الويب"، تحسّن المَعلمة gl نتائج البحث التي يتطابق بلد مصدرها مع . راجِع قسم رموز البلدان للحصول على قائمة بالقيم الصالحة.

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

أمثلة

يعزز هذا الطلب المستندات المكتوبة في المملكة المتحدة باللغة نتائج بحث الويب:
q=pizza&gl=uk


hl
الوصف

Optional. تحدد المعلمة hl لغة الواجهة (لغة المضيف) الخاصة بواجهة المستخدم. للتحسين أداء وجودة نتائج البحث الخاصة بك، فإنك ننصح بشدة بضبط هذه المَعلمة بشكل صريح.

يمكنك الاطّلاع على قسم لغات الواجهة الخاصة بـ تدويل طلبات البحث وعرض النتائج لمزيد من المعلومات ولغات الواجهة المعتمدة للاطّلاع على قائمة باللغات المتاحة

أمثلة

يستهدف هذا الطلب إعلانات النبيذ باللغة الفرنسية. (Vin هو المصطلح الفرنسي "النبيذ").

q=vin&ip=10.10.10.10&ad=w5&hl=fr

جودة عالية
الوصف

Optional. تُلحق المَعلمة hq عبارات طلب البحث المحدّدة بـ الاستعلام، كما لو تم دمجها بعامل AND منطقي.

أمثلة

يبحث هذا الطلب عن "بيتزا" و"الجبن". التعبير هو نفسه q=pizza+cheese.

q=pizza&hq=cheese


ie
الوصف

Optional. تحدد المعلمة ie الحرف نظام الترميز الذي يجب استخدامه لتفسير سلسلة طلب البحث. تشير رسالة الأشكال البيانية قيمة ie التلقائية هي latin1.

راجِع القسم ترميز الأحرف للاطّلاع على مناقشة الحالات التي قد تحتاج فيها إلى استخدام هذه المَعلمة.

راجع ترميز الأحرف قسم المخططات للاطّلاع على قائمة قيم ie المحتمَلة.

أمثلة q=google&ie=utf8&oe=utf8
lr
الوصف

Optional. تحصر مَعلمة lr (حصر اللغة) نتائج البحث بالمستندات. المكتوبة بلغة معينة.

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

  • نطاق المستوى الأعلى (TLD) لعنوان URL للمستند
  • العلامات الوصفية للغة داخل المستند
  • اللغة الأساسية المستخدَمة في النص الأساسي للمستند
  • استخدام لغات ثانوية، إن وجدت، في النص الأساسي للمستند

يمكنك الاطّلاع على اللغة (lr). قسم قيم المجموعة للاطّلاع على قائمة بالقيم الصالحة لهذا الغرض .

أمثلة q=Frodo&lr=lang_en

الرقم
الوصف

Optional. تحدد المعلمة num عدد نتائج البحث المطلوب عرضها.

قيمة num التلقائية هي 10، والحد الأقصى والقيمة هي 20. إذا طلبت أكثر من 20 نتيجة، 20 نتيجة سيتم إرجاع النتائج.

ملاحظة: إذا كان إجمالي عدد نتائج البحث أقل أكبر من العدد المطلوب من النتائج، فستتغير جميع نتائج البحث المتاحة وإرجاعه.

أمثلة q=google&num=10

EE
الوصف

Optional. تحدد المعلمة oe الحرف نظام الترميز الذي يجب استخدامه لفك ترميز نتيجة XML. تشير رسالة الأشكال البيانية قيمة oe التلقائية هي latin1.

راجِع القسم ترميز الأحرف للاطّلاع على مناقشة الحالات التي قد تحتاج فيها إلى استخدام هذه المَعلمة.

راجع ترميز الأحرف قسم المخططات للاطّلاع على قائمة قيم oe المحتمَلة.

أمثلة q=google&ie=utf8&oe=utf8

output
الوصف

مَعلمة مطلوبة. تحدّد المَعلمة output تنسيق نتائج XML. والنوع الوحيد الصالح قيمتا هذه المَعلمة هما xml وxml_no_dtd. تشير رسالة الأشكال البيانية أدناه كيفية اختلاف قيم المعلمات هذه.

القيمة تنسيق الناتج
xml_no_dtd لن تشمل نتائج XML عبارة !DOCTYPE. (موصى به)
xml ستحتوي نتائج XML على رمز الحرف مرجع DTD. سيحدد السطر الثاني من النتيجة المستند نوع التعريف (DTD) الذي تستخدمه النتائج:
    <!DOCTYPE GSP SYSTEM "google.dtd">
أمثلة output=xml_no_dtd
output=xml

q
الوصف

Optional. تحدد المعلمة q طلب البحث طلب البحث الذي أدخله المستخدم. وعلى الرغم من أن هذه المعلمة اختيارية، يجب تحديد قيمة لواحدة على الأقل من معلمات طلب البحث (as_epq وas_lq وas_oq وas_q للحصول على نتائج البحث.

هناك أيضًا عدد من مصطلحات الاستعلام الخاصة التي يمكن كجزء من معلَمة q يُرجى الاطّلاع على عبارات طلبات البحث الخاصة للحصول على قائمة وتعريفاتها.

تتضمن لوحة تحكم "بحث Google" تقريرًا بالجزء العلوي طلب بحث تم إرساله باستخدام مَعلمة q.

ملاحظة: القيمة المحدّدة للمَعلمة q يجب أن يتخطى عنوان URL.

أمثلة q=vacation&as_oq=london+paris

وضع آمن
الوصف

Optional. تشير معلمة safe إلى كيفية تصفية نتائج البحث بحثًا عن محتوى للبالغين المحتوى الإباحي القيمة التلقائية للمَعلمة safe هي off. قيم المَعلمات الصالحة هي:

القيمة الإجراء
off إيقاف "البحث الآمن"
medium تمكين البحث الآمن
high تفعيل إصدار أكثر صرامة من "البحث الآمن"

الاطّلاع على مقالة فلترة محتوى البالغين مع البحث الآمن لمزيد من التفاصيل حول هذه الميزة.

أمثلة q=adult&safe=high

بدء
الوصف

Optional. تشير المعلمة start إلى أول نتيجة مطابقة يجب تضمينها في نتائج البحث. تستخدم المعلمة start فهرسًا قائمًا على صفر، مما يعني أن النتيجة الأولى هي 0، والنتيجة الثانية هي 1 وهكذا.

تعمل المعلمة start في مع المعلمة num لتحديد نتائج البحث المطلوب عرضها. لاحظ أنه لن يتم عرض أكثر من 1000 نتيجة لأي استعلام، حتى إذا تطابق أكثر من 1000 مستند مع الاستعلام، لذا فإن تعيين بداية على 1000 أو أكثر لن ينتج عنه أي نتائج.

أمثلة start=10

ترتيب
الوصف

Optional. تُحدِّد المَعلمة sort أنّه سيتم ترتيب النتائج وفقًا للتعبير المحدّد. على سبيل المثال، الترتيب حسب التاريخ

أمثلة

sort=date


uds
الوصف

Optional. تشير المعلمة ud إلى ما إذا كان يجب أن تتضمّن استجابة XML عنوان URL بترميز IDN لنتيجة البحث. يسمح ترميز IDN (اسم النطاق الدولي) بعرض النطاقات باستخدام المحلي اللغات، مثل:

http://www.花井鮨.com

إنّ القيم الصالحة لهذه المَعلمة هي 1 (الخيار التلقائي)، ما يعني أنّه يجب أن تكون نتيجة XML. أن تتضمّن عناوين URL بترميز IDN و0، ما يعني أنّه يجب ألّا تتضمّن نتيجة XML بترميز IDN عناوين URL. إذا تم ضبط المَعلمة ud على 1، سيظهر عنوان URL بترميز IDN في في العلامة UD في نتائج XML.

إذا تم ضبط المَعلمة ud على 0، سيكون عنوان URL في المثال أعلاه كما يلي: معروض على النحو التالي:

http://www.xn--elq438j.com.

ملاحظة: هذه ميزة تجريبية.

أمثلة q=google&ud=1

إنّ مَعلمات طلب البحث الإضافية المدرَجة أسفل الصورة ذات صلة بطلبات البحث المتقدّم. عند إرسال بحث متقدم، تظهر قيم عدة معلَمات (مثل as_eq، as_epq وas_oq وما إلى ذلك) جميعها في طلب البحث مصطلحات البحث هذا. تعرض الصورة صفحة "البحث المتقدم" من Google. في الصورة، سيظهر اسم كل معلمة البحث المتقدم مكتوبة بنص أحمر داخل أو بجانب الحقل على الصفحة الذي تتجاوب معه هذه المعلمة.



معلمات طلب البحث المتقدم

as_dt
الوصف

Optional. تتحكم معلمة as_dt في ما إذا لتضمين النتائج أو استبعادها من الموقع الإلكتروني المحدَّد في المَعلمة as_sitesearch. تشير رسالة الأشكال البيانية تشير القيمتان i وe إلى تضمين المحتوى واستبعاده على التوالي.

أمثلة as_dt=i,as_dt=e

as_epq
الوصف

Optional. تحدد المعلمة as_epq عبارة يجب أن تحتوي عليها جميع المستندات في نتائج البحث. يمكنك أيضًا استخدام عبارة طلب البحث لبحث العبارة ابحث عن عبارة.

أمثلة as_epq=abraham+lincoln

as_eq
الوصف

Optional. تحدد المعلمة as_eq كلمة ما أو عبارة يجب ألا تظهر في أي مستندات في البحث نتائجك. يمكنك أيضًا استخدام طلب البحث excluded مصطلح لضمان عدم ظهور كلمة أو عبارة معينة في مستندات في مجموعة من نتائج البحث.

أمثلة

q=bass&as_eq=music.


as_lq
الوصف

Optional. تحدد المعلمة as_lq ما يلي: ينبغي أن تشتمل جميع نتائج البحث على رابط إلى عنوان URL محدد. يمكنك أيضًا استخدِم عبارة طلب البحث link: لهذا النوع من طلبات البحث.

أمثلة

as_lq=www.google.com


as_nlo
الوصف

Optional. تحدد المعلمة as_nlo قيمة البدء نطاق بحث. استخدام as_nlo وas_nhi لإلحاق عملية بحث شاملة نطاق as_nlo...as_nhi إلى الاستعلام.

أمثلة

في ما يلي نطاق بحث يتراوح بين 5 و10، بشكل شامل:

as_nlo=5&as_nhi=10

as_nhi
الوصف

Optional. تحدد المعلمة as_nhi القيمة النهائية لنطاق بحث. استخدام as_nlo وas_nhi لإلحاق نطاق البحث الشامل من as_nlo...as_nhi لطلب البحث.

أمثلة

في ما يلي نطاق بحث يتراوح بين 5 و10، بشكل شامل:

as_nlo=5&as_nhi=10

as_oq
الوصف

Optional. توفر المعلمة as_oq عبارات بحث إضافية للتحقق منها في أحد المستندات، حيث يتم تضمين كل مستند في نتائج البحث يجب أن يحتوي على واحد على الأقل من عبارات البحث. يمكنك أيضًا استخدام عبارة طلب البحث المنطقية OR لهذا النوع من الاستعلام.

أمثلة

q=vacation&as_oq=London+Paris


as_q
الوصف

Optional. توفر المعلمة as_q إمكانية البحث البنود التي يجب التحقق منها في الوثيقة. هذه المعلمة مستخدمة أيضًا بشكل شائع للسماح للمستخدمين بتحديد مصطلحات إضافية للبحث عنها داخل مجموعة من نتائج البحث.

أمثلة

q=president&as_q=John+Adams


as_qdr
الوصف

Optional. معلَمة as_qdr تطلب البحث النتائج من فترة زمنية محددة (نطاق زمني سريع). في ما يلي القيم المسموح بها:

يطلب d[number] نتائج من العدد المحدّد من الأيام الماضية.
هناك w[number] طلب نتائج من العدد المحدّد من الأسابيع الماضية.
هناك طلبان (m[number]) بنتائج من العدد المحدّد للأشهر الماضية.
هناك طلب من y[number] للحصول على نتائج من العدد المحدّد من السنوات الماضية.

أمثلة

يطلب هذا المثال نتائج من العام الماضي:

as_qdr=y

يطلب هذا المثال نتائج من آخر 10 أيام:

as_qdr=d10

as_sitesearch
الوصف

Optional. مَعلمة as_sitesearch، يمكنك تحديد أنّ جميع نتائج البحث يجب أن تكون صفحات من موقع إلكتروني معيّن. من خلال ضبط المَعلمة as_dt، يمكنك أيضًا استخدامها لاستبعاد صفحات من موقع إلكتروني معيّن من نتائج البحث.

أمثلة

q=vacation&as_sitesearch=www.google.com


عبارات طلبات البحث الخاصة

يتيح بحث الويب من Google استخدام العديد من مصطلحات الاستعلام الخاصة التي الوصول إلى إمكانات إضافية لمحرك بحث Google. هذه تضمين عبارات طلب البحث الخاصة في قيمة معلَمة الطلب q. مثل مصطلحات الاستعلام الأخرى، يجب أن تكون عبارات البحث الخاصة تتضمن إلغاء عنوان URL. حاسمة عدد عبارات طلب البحث الخاصة التي تحتوي على نقطتين (:). هذه الشخصية يجب أن يتضمن حروف إلغاء عنوان URL أيضًا؛ وقيمته التي تتضمن حروف إلغاء عنوان URL هي %3A.

الروابط الخلفية [link:]
الوصف

عبارة طلب البحث link: تعرض مجموعة صفحات الويب التي ترتبط بعنوان URL معين. يجب تنسيق طلب البحث على النحو التالي: link:URL بدون مسافة بين عبارة طلب البحث link: وعنوان URL.

إصدار link: الذي يتضمن حروف إلغاء عنوان URL هو link%3A.

يمكنك أيضًا استخدام طلب as_lq لإرسال طلب link:.

ملاحظة: لا يمكنك تحديد أي عبارات طلب بحث أخرى عندما باستخدام link:.

أمثلة

http://www.google.com/search?q=link%3Awww.example.com


منطقية OR بحث [ أو ]
الوصف

تسترد عبارة طلب البحث OR المستندات التي تشتمل على واحد من سلسلة من عبارات طلب البحث (اثنتان أو أكثر). لاستخدام طلب البحث OR العبارة، يجب إدراج عبارة البحث OR بالأحرف اللاتينية الكبيرة بين كل مصطلح في السلسلة.

يمكنك أيضًا استخدام طلب as_oq لإرسال بحث عن أي عبارة في مجموعة من العبارات.

ملاحظة: إذا كان طلب البحث طلب البحث "لندن+OR+باريس"، ستتضمن نتائج البحث مستندات تحتوي على واحدة على الأقل من هاتين الكلمتين. في بعض الحالات، مستندات في نتائج البحث تحتوي على كلتا الكلمتين.

أمثلة

البحث عن لندن أو باريس:

إدخال المستخدم:london OR paris عبارة طلب البحث:q=london+OR+paris

ابحث عن عطلة وإما لندن أو باريس:

عبارة طلب البحث:q=vacation+london+OR+paris

ابحث عن عطلة وأحد مدن لندن أو باريس أو الشوكولاتة:

عبارة طلب البحث:  q=vacation+london+OR+paris+OR+chocolates

ابحث عن العطلات والشوكولاتة وإما لندن أو باريس، بأقل وزن يتم منحه للشوكولاتة:

عبارة طلب البحث:  q=vacation+london+OR+paris+chocolates

ابحث عن عطلة وشوكولاتة وزهور في مستندات أيضًا إما لندن أو باريس:

عبارة طلب البحث:  q=vacation+london+OR+paris+chocolates+flowers

ابحث عن إجازة وأحد لندن أو باريس وابحث أيضًا لإحدى الشوكولاتة أو الزهور:

عبارة طلب البحث:  q=vacation+london+OR+paris+chocolates+OR+flowers

استبعاد عبارة طلب البحث [-]
الوصف

تؤدّي عبارة طلب البحث "استبعاد (-)" إلى تقييد نتائج طلب بحث معين للمستندات التي لا تحتوي على كلمة أو عبارة معينة. لاستخدام عبارة استبعاد طلب البحث، يمكنك ابدأ بالكلمة أو العبارة المراد استبعادها من المستندات المطابقة مع "-" (علامة الطرح).

إصدار - الذي يتضمن حروف إلغاء عنوان URL هو %2D.

تكون عبارة استبعاد طلب البحث مفيدة عندما تحتوي عبارة البحث على عدد أكبر من أكثر من معنى واحد. على سبيل المثال، يمكن أن تشير كلمة "باس" يمكن أن تعرض نتائج سواء عن الأسماك أو الموسيقى. إذا كنت تبحث عن وثائق حول يمكنك استبعاد مستندات حول الموسيقى من نتائج البحث باستخدام عبارة استبعاد طلب البحث.

يمكنك أيضًا استخدام طلب as_eq لاستبعاد المستندات التي تطابق كلمة أو عبارة معيّنة من نتائج البحث.

أمثلة البيانات التي أدخلها المستخدم: bass -music
عبارة طلب البحث: q=bass+%2Dmusic

استبعاد نوع الملف [ -filetype: ]
الوصف

تستثني عبارة طلب البحث -filetype: المستندات التي تحتوي على بامتداد ملف معين، مثل "pdf." أو " .doc" من البحث نتائجك. يجب تنسيق طلب البحث على النحو التالي: -filetype:EXTENSION بدون مسافة بين عبارة طلب البحث -filetype: الإضافة المحددة.

إصدار -filetype: الذي يتضمن حروف إلغاء عنوان URL هو %2Dfiletype%3A.

ملاحظة: يمكنك استبعاد عدة مواقع أنواع الملفات من نتائج البحث من خلال إضافة المزيد من طلبات البحث -filetype: العبارات إلى استعلامك. يجب أن يكون لديك عبارة بحث واحدة (-filetype:) في طلب البحث لكل امتداد ملف يجب استبعاده من نتائج البحث.

تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • لوتس 1-2-3 (أسبوع 1، أسبوع 2، أسبوع 3، أسبوع 4، أسبوع 5، wki، أسبوع، wku)
  • اللوتس WordPro (lwp)
  • Macكتابة (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (أسبوع، wps، wdb)
  • Microsoft Write (wri)
  • تنسيق نصوص منسّقة (rtf)
  • Shockwave Flash (swf)
  • نص (ans, txt).

يمكن إضافة أنواع ملفات إضافية في المستقبل. تحديث التي يمكن العثور عليها دائمًا في الأسئلة الشائعة حول نوع ملف Google.

أمثلة

يعرض هذا المثال المستندات التي تشير إلى "Google" لكن ذلك ليست مستندات PDF:
q=Google+%2Dfiletype%3Apdf

يعرض هذا المثال المستندات التي تشير إلى "Google" لكن باستثناء مستندات PDF وWord:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


تصفية نوع الملف [ filetype: ]
الوصف

تحصر عبارة طلب البحث filetype: نتائج البحث على مستندات بامتداد ملف معين، مثل "pdf." أو " .doc". يجب تنسيق طلب البحث على النحو التالي filetype:EXTENSION مع عدم وجود مسافة بين عبارة طلب البحث filetype: والمحددة الإضافة.

إصدار filetype: الذي يتضمن حروف إلغاء عنوان URL هو filetype%3A.

يمكنك حصر إمكانية البحث. النتائج إلى المستندات التي تتطابق مع أحد امتدادات الملفات العديدة عن طريق إضافة filetype: عبارة بحث إضافية إلى طلب بحثك. يجب أن تكون لديك عبارة بحث filetype: واحدة في طلب البحث لكل امتداد ملف يجب تضمينه في نتائج البحث. يجب فصل عبارات طلب البحث المتعددة في filetype: باستخدام عبارة طلب البحث OR.

بشكل افتراضي، تضمين مستندات بأي امتداد ملف

تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:

  • Adobe Portable Document Format (pdf)
  • Adobe PostScript (ps)
  • لوتس 1-2-3 (أسبوع 1، أسبوع 2، أسبوع 3، أسبوع 4، أسبوع 5، wki، أسبوع، wku)
  • اللوتس WordPro (lwp)
  • Macكتابة (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (doc)
  • Microsoft Works (أسبوع، wps، wdb)
  • Microsoft Write (wri)
  • تنسيق نصوص منسّقة (rtf)
  • Shockwave Flash (swf)
  • نص (ans, txt).

يمكن إضافة أنواع ملفات إضافية في المستقبل. تحديث التي يمكن العثور عليها دائمًا في الأسئلة الشائعة حول نوع ملف Google.

أمثلة

يعرض هذا المثال مستندات PDF التي تشير إلى "Google":
q=Google+filetype%3Apdf

يعرض هذا المثال مستندات PDF وWord التي تشير إلى "Google":
q=Google+filetype%3Apdf+OR+filetype%3Adoc


تضمين عبارة طلب البحث [+]
الوصف

يحدد مصطلح طلب البحث الخاص بالتضمين (+) أن الكلمة أو العبارة في جميع المستندات المضمَّنة في نتائج البحث. لاستخدام تضمين مصطلح طلب بحث، فستبدأ بتمهيد الكلمة أو العبارة التي يجب تم تضمينها في جميع نتائج البحث مع علامة "+" (علامة زائد).

إصدار + الذي يتضمن حروف إلغاء عنوان URL (علامة الجمع) هو %2B.

يجب استخدام + قبل كلمة شائعة يستخدمها محرّك بحث Google يتم تجاهلها عادة قبل تحديد نتائج البحث.

أمثلة البيانات التي أدخلها المستخدم: Star Wars Episode +I
عبارة طلب البحث: q=Star+Wars+Episode+%2BI

البحث عن روابط فقط، جميع العبارات [ allinlinks: ]
الوصف

تتطلب عبارة طلب البحث allinlinks: إضافة المستندات إلى نتائج البحث لاحتواء جميع الكلمات الواردة في طلب البحث في URL . يجب أن يكون طلب البحث بالتنسيق allinlinks: متبوعًا بالكلمات الواردة في طلب البحث.

إذا كان طلب البحث يتضمّن طلب البحث allinlinks: ستتحقق Google فقط من روابط عناوين URL في المستندات بحثًا عن الكلمات في طلب البحث، وتجاهل النصوص الأخرى في المستندات، عناوين المستندات وعناوين URL لكل مستند. لاحظ أن الوثيقة يختلف عنوان URL عن روابط عناوين URL المضمَّنة في المستند.

إصدار allinlinks: الذي يتضمن حروف إلغاء عنوان URL هو allinlinks%3A.

أمثلة البيانات التي أدخلها المستخدم:allinlinks: Google search
عبارة طلب البحث:q=allinlinks%3A+Google+search

البحث بالعبارات
الوصف

تسمح لك عبارة طلب بحث العبارة (") بالبحث عن عن طريق تضمين العبارات بين علامتي اقتباس أو لربطها بواصلات.

إصدار " الذي يتضمن حروف إلغاء عنوان URL (علامة اقتباس) هو %22.

تعتبر عمليات البحث بالعبارات مفيدة بشكل خاص إذا كنت تبحث للاقتباسات المشهورة أو أسماء العلم.

يمكنك أيضًا استخدام طلب as_epq. لإرسال بحث بالعبارات.

أمثلة البيانات التي أدخلها المستخدم:"Abraham Lincoln"
عبارة طلب البحث: q=%22Abraham+Lincoln%22

البحث في النص فقط، جميع العبارات [allintext:]
الوصف

تتطلب عبارة طلب البحث allintext: أن يكون كل مستند في نتائج البحث لاحتواء جميع الكلمات الواردة في طلب البحث في نص الوثيقة. يجب تنسيق طلب البحث على النحو التالي: allintext: متبوعًا بالكلمات الواردة في طلب البحث.

إذا كان طلب البحث يتضمّن طلب البحث allintext: العبارة، فستتحقق Google فقط من النص الأساسي للمستندات بحثًا عن الكلمات في طلب البحث، مع تجاهل الروابط في تلك المستندات، وعناوين URL للمستندات.

إصدار allintext: الذي يتضمن حروف إلغاء عنوان URL هو allintext%3A.

أمثلة يحدد هذا المثال أن الكلمات "Google" و"بحث" أن يظهر في النص الأساسي لكل المستندات المضمّنة في نتائج البحث:
إدخال المستخدم:allintext:Google search
عبارة طلب البحث:q=allintext%3AGoogle+search

بحث العنوان، مصطلح واحد [intitle:]
الوصف

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

ملاحظة: يمكنك تحديد المزيد أكثر من كلمة واحدة يجب تضمينها في عنوان المستند عن طريق عبارة طلب البحث intitle: أمام كل كلمة. يمكنك أيضًا استخدام عبارة طلب البحث allintitle: بهدف تحديد أنه يجب تضمين جميع كلمات الاستعلام في عناوين المستندات التي توجد في نتائج البحث.

إصدار intitle: الذي يتضمن حروف إلغاء عنوان URL هو intitle%3A.

أمثلة

ويحدّد هذا المثال أن كلمة "Google" يجب أن يظهر في وعناوين أي مستندات في نتائج البحث، بالإضافة إلى "بحث" يجب أن تظهر في أي مكان في العناوين أو عناوين URL أو الروابط أو النص الأساسي من هذه المستندات:
إدخال المستخدم:intitle:Google search
عبارة طلب البحث:q=intitle%3AGoogle+search


البحث في العنوان، جميع العبارات [allintitle:]
الوصف

تحصر عبارة طلب البحث allintitle: نتائج البحث على المستندات التي تحتوي على جميع كلمات الاستعلام في عنوان المستند. إلى استخدام عبارة طلب البحث allintitle:، ضمِّن "allintitle:" في بداية طلب البحث.

ملاحظة: يتساوى وضع allintitle: في بداية طلب البحث مع وضع intitle: أمام كل كلمة في عملية البحث. طلب البحث.

إصدار allintitle: الذي يتضمن حروف إلغاء عنوان URL هو allintitle%3A.

أمثلة

يحدد هذا المثال أن الكلمات "Google" و"بحث" في عناوين أي مستندات في نتائج البحث:
إدخال المستخدم: allintitle: Google search
عبارة طلب البحث: q=allintitle%3A+Google+search


البحث عن عنوان URL، عبارة واحدة [inurl:]
الوصف

تحصر عبارة طلب البحث inurl: نتائج البحث على المستندات التي تحتوي على كلمة معينة في عنوان URL للمستند. تشير رسالة الأشكال البيانية يجب أن يكون طلب البحث بالتنسيق inurl:WORD بدون مسافة. بين عبارة طلب البحث inurl: والكلمة التالية.

طلب البحث inurl: عبارة تتجاهل علامات الترقيم وتستخدم الكلمة الأولى فقط بعد عامل التشغيل inurl:. يمكنك تحديد أكثر من كلمة واحدة يجب تضمينها في عنوان URL للمستند من خلال وضع عبارة طلب البحث inurl: أمام لكل كلمة من هذه الكلمات. يمكنك أيضًا استخدام عبارة طلب البحث allinurl: لتحديد ضرورة تضمين جميع كلمات طلب البحث في عناوين URL من المستندات التي تظهر في نتائج البحث.

إصدار inurl: الذي يتضمن حروف إلغاء عنوان URL هو inurl%3A.

أمثلة

ويحدّد هذا المثال أن كلمة "Google" يجب أن يظهر في وعناوين URL لأي مستندات في نتائج البحث، بالإضافة إلى كلمة "بحث" في أي مكان في العناوين أو عناوين URL أو الروابط أو النص الأساسي لتلك العناوين المستندات:
إدخال المستخدم: inurl:Google search
عبارة طلب البحث: q=inurl%3AGoogle+search


البحث عن عنوان URL، كل العبارات [allinurl:]
الوصف

تحصر عبارة طلب البحث allinurl: نتائج البحث على المستندات التي تحتوي على جميع كلمات الاستعلام في عنوان URL للمستند. إلى استخدام عبارة طلب البحث allinurl:، وإدراج allinurl: في البداية طلب البحث.

تتجاهل عبارة طلب البحث allinurl: علامات الترقيم، لذا فهي تعمل مع الكلمات فقط وليس على عنوان URL. والمكونات. على سبيل المثال، سيحظر allinurl: uk/scotland النتائج. إلى المستندات التي تحتوي على الكلمات "uk" و"اسكتلندا" في عناوين URL الخاصة بهم، ولكنها لن تشترط أن تظهر هاتين الكلمتين بأي شكل بالترتيب أو أن يتم فصلها بشرطة مائلة.

إصدار allinurl: الذي يتضمن حروف إلغاء عنوان URL هو allinurl%3A.

أمثلة

يحدد هذا المثال أن الكلمات "Google" و"بحث" في عناوين URL لأي مستندات في نتائج البحث:
إدخال المستخدم: allinurl: Google search
عبارة طلب البحث: q=allinurl%3A+Google+search



معلومات مستند الويب [info:]
الوصف

تسترد عبارة طلب البحث info: معلومات عامة عن عنوان URL ما دام هذا العنوان مضمّنًا في فهرس البحث على Google. يجب تنسيق طلب البحث على النحو التالي info:URL بدون مسافة. بين عبارة طلب البحث info: وعنوان URL.

إصدار info: الذي يتضمن حروف إلغاء عنوان URL هو info%3A.

ملاحظة: لا يمكنك تحديد أي عبارات طلب بحث أخرى عندما باستخدام info:.

أمثلة البيانات التي أدخلها المستخدم: info:www.google.com
عبارة طلب البحث: q=info%3Awww.google.com

نماذج طلبات بحث عن الصور

تعرض الأمثلة أدناه بعض طلبات HTTP للصور لتوضيح كيفية استخدام مَعلمات طلب البحث المختلفة. تتوفّر تعريفات لمَعلمات طلب البحث المختلفة في أقسام تعريفات مَعلمات طلب البحث بالصور في هذا المستند.

يطلب هذا الطلب أول 5 نتائج (start=0&num=5) لعبارة البحث "قرد" (q=monkey)، من نوع الملف .png وأخيرًا، يحدد الاستعلام قيمًا للمعلمات client وoutput وcx، وجميعها مطلوبة.

http://www.google.com/cse?
  searchtype=image
  start=0
  &num=5
  &q=monkey
  &as_filetype=png
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

معلمات طلب البحث عن الصور

as_filetype
الوصف

Optional. لعرض صور من نوع محدد. القيم المسموح بها هي: bmp وgif وpng وjpg وsvg.

أمثلة q=google&as_filetype=png

imgsz
الوصف

Optional. لعرض صور بحجم محدد، حيث يمكن أن يكون الحجم واحدًا مما يلي:

  • icon (صغير)
  • small|medium|large|xlarge (متوسط)
  • xxlarge (كبير)
  • huge (كبير جدًا)

أمثلة q=google&as_filetype=png&imgsz=icon

نوع الصورة
الوصف

Optional. عرض صور من نوع معين يمكن أن تكون أيًا مما يلي:

  • clipart (القطع)
  • face (وجه)
  • lineart (خطية)
  • news (الأخبار)
  • photo (صورة)

أمثلة q=google&as_filetype=png&imgtype=photo

imgc
الوصف

Optional. لعرض صور بالأبيض والأسود أو بتدرج الرمادي أو ملونة:

  • mono (بالأبيض والأسود)
  • gray (تدرج الرمادي)
  • color (اللون)

أمثلة q=google&as_filetype=png&imgc=gray

imgcolor
الوصف

Optional. لعرض صور لون بارز معين:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
أمثلة q=google&as_filetype=png&imgcolor=yellow

as_rights
الوصف

Optional. الفلاتر المُستنِدة إلى الترخيص. وتشمل القيم المسموح بها ما يلي:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

أمثلة q=cats&as_filetype=png&as_rights=cc_attribute

الحدود القصوى للطلبات

يسرد الجدول أدناه القيود المفروضة على طلبات البحث التي إرسال إلى Google:

المكوّن الحدّ المسموح به تعليق
مدة طلب البحث 2048 بايت  
عدد عبارات طلب البحث 10 يتضمّن عبارات في المَعلمات التالية: q وas_epq وas_eq وas_lq وas_oq وas_q
عدد النتائج 20 إذا تم ضبط المعلمة num على رقم أكبر من 20، سيتم عرض 20 نتيجة فقط. إلى ستحصل على نتائج أكثر، فستحتاج إلى إرسال طلبات متعددة زيادة قيمة المَعلمة start باستخدام لكل طلب.

عرض الاستعلامات والنتائج الدولية

تمكّنك خدمة "بحث الويب من Google" من البحث عن مستندات في لغات متعددة. يمكنك تحديد ترميز الأحرف الذي يجب يمكن استخدامها لتفسير طلب HTTP وترميز استجابة XML (باستخدام البحث ie وoe) المعلمات). يمكنك أيضًا فلترة النتائج لتضمين المستندات فقط. المكتوبة بلغات معينة.

تناقش الأقسام التالية المشكلات المتعلقة بالبحث باستخدام لغات متعددة:

ترميز الأحرف

ترسل الخوادم بيانات، مثل صفحات الويب، إلى برامج وكيل المستخدم، مثل المتصفحات، كسلسلة من وحدات البايت المشفرة. يقوم وكيل المستخدم بعد ذلك بفك ترميز وحدات البايت إلى سلسلة من الأحرف. عند إرسال طلبات إلى خدمة "بحث الويب"، يمكنك تحديد مخططات الترميز لكل من لطلب البحث واستجابة XML التي تتلقاها.

يمكنك استخدام معلمة الطلب ie لتحديد آلية ترميز الأحرف في طلب HTTP. يمكنك أيضًا استخدام المعلمة oe لتحديد الترميز يجب أن تستخدمه Google لترميز استجابة XML. إذا كنت باستخدام نظام ترميز غير ISO-8859-1 (أو latin1)، يُرجى التأكّد من تحديد القيم الصحيحة. للمعلمتَين ie وoe.

ملاحظة: إذا كنت توفر وظيفة البحث لعدة مواقع لغة، ننصحك باستخدام قيمة الترميز utf8 (UTF-8) لكل من المَعلمتَين ie وoe.

يُرجى الرجوع إلى الشخصية مخططات الترميز للاطّلاع على قائمة كاملة بالقيم يمكنك استخدامها للمعلمتَين ie وoe.

لمزيد من المعلومات العامة حول ترميز الأحرف، يُرجى الاطّلاع على http://www.w3.org/TR/REC-html40/charset.html.

لغات الواجهة

يمكنك استخدام معلمة الطلب hl التعرف على لغة الواجهة الرسومية. قد تؤثر قيمة المعلمة hl في نتائج بحث XML، خاصةً في طلبات بحث دولية عندما لا يتم تحديد تقييد اللغة (باستخدام المعلمة lr) بشكلٍ صريح. في مثل هذه الحالات، قد تروِّج المعلمة hl لنتائج البحث باللغة نفسها المستخدَمة في لغة الإدخال للمستخدم

نقترح عليك ضبط المَعلمة hl بشكل صريح. في نتائج البحث لضمان اختيار Google لأعلى جودة نتائج البحث لكل طلب بحث.

يُرجى الاطلاع على الواجهة المتوافقة قسم "اللغات" للاطّلاع على قائمة كاملة بالقيم الصالحة للمَعلمة hl.

البحث عن مستندات مكتوبة بلغات محددة

يمكنك استخدام معلمة الطلب lr من أجل قصر نتائج البحث على المستندات المكتوبة بطريقة أو لغة واحدة أو مجموعة من اللغات.

تتوافق المَعلمة lr مع العوامل المنطقية للسماح لك بتحديد لغات متعددة يجب تضمينها (أو استبعادها) من البحث نتائجك.

توضِّح الأمثلة التالية كيفية استخدام عوامل التشغيل المنطقية لطلب المستندات وفقًا بلغات مختلفة.

بالنسبة إلى المستندات المكتوبة باللغة اليابانية:

lr=lang_jp

بالنسبة إلى المستندات المكتوبة باللغة الإيطالية أو الألمانية:

lr=lang_it|lang_de

بالنسبة إلى المستندات غير المكتوبة باللغة المجرية أو التشيكية:

lr=(-lang_hu).(-lang_cs)

يُرجى الاطّلاع على مجموعة اللغات. قسم القيم للحصول على قائمة كاملة بالقيم المحتملة للمَعلمة lr والقيمة المنطقية قسم "عوامل التشغيل" للاطّلاع على مناقشة كاملة حول استخدام هذه والمشغلات.

الصينية المبسطة والصينية التقليدية هما متغيران للكتابة باللغة الصينية. يمكن كتابة نفس المفهوم بشكل مختلف في لكل صيغة. بناءً على طلب بحث في إحدى الصيغ، يحدد يمكن لخدمة "بحث الويب" عرض نتائج تشتمل على صفحات في كليهما مختلفة.

لاستخدام هذه الميزة:

  1. ضبط مَعلمة طلب c2coff على 0
    أو
  2. نفّذ أيًا مما يلي:
    • عدم ضبط مَعلمة الطلب lr
      أو
    • ضبط معلمة طلب lr على lr=lang_zh-TW|lang_zh-CN

يوضح المثال التالي معلَمات طلب البحث التي تريد تضمينها في طلب النتائج. في كل من الصينية المبسّطة والتقليدية (لاحظ أن المعلومات الإضافية المطلوبة، مثل باعتباره العميل، لم يتم تضمينه في المثال).

search?hl=zh-CN
    &lr=lang_zh-TW|lang_zh-CN
    &c2coff=0

فلترة النتائج

يوفر "بحث الويب من Google" عدة طرق لفلترة نتائج بحثك. النتائج:

التصفية التلقائية لنتائج البحث

سعيًا إلى توفير أفضل نتائج بحث ممكنة، استخدم محرّك بحث Google أسلوبين لتصفية نتائج البحث تلقائيًا تُعد غير مرغوب فيها عمومًا:

  • المحتوى المكرّر: في حال احتوت مستندات متعددة على نفس المعلومات، يتم عندها فقط المستند الأكثر صلة من هذه المجموعة تضمينها في نتائج البحث.

  • تجميع المضيف: إذا كان هناك العديد من نتائج البحث من الموقع نفسه، فقد لا يعرض محرك بحث Google جميع النتائج من ذلك الموقع أو قد عرض النتائج في أسفل
    الترتيب عما كانت ستكون عليه بخلاف ذلك.

ننصحك بإبقاء هذه الفلاتر مفعَّلة لطلبات البحث المعتادة. لأنّ الفلاتر تحسّن جودة معظم عمليات البحث بشكل كبير نتائجك. مع ذلك، يمكنك تجاوز هذه الفلاتر التلقائية عن طريق ضبط معلَمة طلب البحث الفلتر على 0 في طلب البحث.

فلترة اللغة والبلد

خدمة "بحث الويب من Google" تعرض نتائج من فهرس رئيسي يضم جميع مستندات الويب. يحتوي الفهرس الرئيسي على مجموعات فرعية من مستندات يتم تجميعها حسب سمات معيَّنة، بما في ذلك اللغة وبلد المنشأ.

يمكنك استخدام مَعلمتَي الطلب lr وcr لحصر نتائج البحث بالمجموعات الفرعية من مستندات مكتوبة بلغات معينة أو تنشأ من بلدين معينين، على التوالي.

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

  • نطاق المستوى الأعلى (TLD) لعنوان URL للمستند
  • العلامات الوصفية للغة داخل المستند
  • اللغة الأساسية المستخدَمة في النص الأساسي للمستند


يُرجى أيضًا الاطلاع على تعريف المعلمة lr، القسم الذي يتناول البحث عن المستندات المكتوبة بلغات معيّنة وقيم جمع اللغات التي يمكن استخدامها تُستخدم كقيم للمَعلمة lr من أجل المزيد معلومات حول تقييد النتائج استنادًا إلى اللغة.

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

  • نطاق المستوى الأعلى (TLD) لعنوان URL للمستند
  • الموقع الجغرافي لعنوان IP لخادم الويب

يُرجى أيضًا الاطّلاع على تعريف المَعلمة cr ومجموعة البلدان. القيم التي يمكن استخدامها كقيم للمَعلمة cr لمزيد من المعلومات حول تقييد النتائج حسب بلد المصدر.

ملاحظة: يمكنك الجمع بين اللغات. وقيم البلد لتخصيص نتائج البحث. بالنسبة على سبيل المثال، يمكنك طلب وثائق مكتوبة باللغة الفرنسية من فرنسا أو كندا، أو يمكنك طلب المستندات التي من هولندا وليست مكتوبة باللغة الإنجليزية. تتوافق المعلمتان lr وcr مع العوامل المنطقية.

تصفية محتوى البالغين باستخدام ميزة "البحث الآمن"

لا يرغب العديد من عملاء Google في عرض نتائج بحث لما يلي: المواقع الإلكترونية التي تحتوي على محتوى للبالغين. وباستخدام فلتر البحث الآمن، يمكنك فحص عن نتائج البحث التي تتضمن محتوى للبالغين وإزالتها. تستخدم فلاتر Google تكنولوجيا مملوكة للشركة للتحقّق من الكلمات الرئيسية والعبارات. وعناوين URL. وعلى الرغم من أنه ليست هناك فلاتر دقيقة بنسبة 100%، فإن ميزة "البحث الآمن" ستجري إزالة الغالبية العظمى من المحتوى المخصص للبالغين من عملية بحثك نتائجك.

تسعى Google جاهدة إلى إبقاء ميزة "البحث الآمن" حديثة وشاملة من خلال الزحف المستمر إلى الويب ودمج التحديثات من اقتراحات المستخدمين

تتوفر ميزة "البحث الآمن" باللغات التالية:

الهولندية
الإنجليزية
الفرنسية
الألمانية
الإيطالية
البرتغالية (البرازيلية)
الإسبانية
الصينية التقليدية

يمكنك تعديل درجة فلترة Google للنتائج حسبها. للبالغين باستخدام معلمة طلب البحث safe. يوضح الجدول التالي إعدادات البحث الآمن في Google وكيف يمكن تأثير الإعدادات في نتائج البحث:

مستوى "البحث الآمن" الوصف
مرتفعة تفعيل إصدار أكثر صرامة من البحث الآمن.
متوسط يحظر هذا الإعداد صفحات الويب التي تحتوي على المواد الإباحية وأي محتوى جنسي فاضح آخر
إيقاف لا يصفي محتوى البالغين المحتوى من نتائج البحث.

* الإعداد التلقائي لميزة "البحث الآمن" هو إيقاف.

إذا كانت ميزة "البحث الآمن" مفعّلة وعثرت على مواقع تحتوي على محتوى مسيء في النتائج، يُرجى إرسال رسالة إلكترونية إلى عنوان URL للموقع إلى safesearch@google.com، فحص الموقع.

نتائج XML

DTD للنتائج بتنسيق XML من Google

وتستخدم Google نفس DTD لوصف تنسيق XML لجميع أنواع نتائج البحث. ينطبق العديد من العلامات والسمات على جميع أنواع البحث. ومع ذلك، تنطبق بعض العلامات على أنواع محددة فقط أنواع البحث. وبالتالي، قد تكون التعريفات في الإحالة الناجحة للمسؤولية عن بُعد أقل من البيانات أكثر من التعريفات المقدمة في هذا المستند.

تصف هذه الوثيقة الجوانب ذات الصلة من DTD لبحث الويب. عند النظر إلى DTD، إذا كنت تعمل في WebSearch، يمكنك تجاهل العلامات والسمات التي لا موثقة هنا. إذا اختلف التعريف بين DTD الوثائقي، هذه الحقيقة مذكورة في هذه الوثيقة.

يمكن أن يعرض محرك بحث Google نتائج XML إما تتضمن مرجعًا أو بدونه. آخر DTD. DTD هو دليل لمساعدة مشرفي البحث ومحللات XML تفهم نتائج XML من Google. ولأن تنسيق XML في Google قد تتغير القواعد النحوية من حين لآخر، فلا يجب عليك تهيئة محلل لغوي لاستخدام DTD للتحقق من صحة كل نتيجة بتنسيق XML.

بالإضافة إلى ذلك، يجب عدم تهيئة محلل XML لجلب DTD في كل مرة ترسل فيها طلب بحث. تعدّل Google البيانات المقدَّمة من قِبل المستخدم. بشكل غير متكرر، وتؤدي هذه الطلبات إلى تأخير غير ضروري ومعدل نقل بيانات متطلبات المشروع.

وتوصي Google باستخدام تنسيق الإخراج xml_no_dtd للحصول على نتائج بتنسيق XML. إذا حددت تنسيق xml output في طلب البحث، الاختلاف الوحيد هو تضمين السطر التالي في نتائج XML:

<!DOCTYPE GSP SYSTEM "google.dtd">

يمكنك الوصول إلى آخر يوم لتاريخ الميلاد على http://www.google.com/google.dtd.

يُرجى العِلم أنّه قد لا تتوفّر بعض الميزات في التقرير حتى الآن أو متاحة في الوقت الحالي.

لمحة عن استجابة XML

  • جميع قيم العناصر هي رموز HTML صالحة للعرض ما لم مذكورة خلافًا لذلك في تعريفات علامات XML.
  • بعض قيم العناصر هي عناوين URL يجب ترميزها بتنسيق HTML قبل التي يتم عرضها.
  • يجب أن يتجاهل محلّل XML السمات والعلامات غير الموثَّقة. يتيح هذا الإجراء لتطبيقك مواصلة العمل بدون تعديل. إذا أضافت Google المزيد من الميزات إلى ناتج XML.
  • يجب تخطي أحرف معينة عند تضمينها كقيم في علامات XML: وينبغي أن يحوّل معالج XML هذه الكيانات مرة أخرى إلى الأحرف المناسبة. إذا لم تحوّل الكيانات بشكل صحيح، على سبيل المثال، يعرض المتصفح الرمز & "&amp;". يتضمن ملف XML المستندات العادية هذه الأحرف: هذه الأحرف وإعادة إنتاجها في الجدول أدناه:

    حرف النماذج التي تم تجاهلها الكيان رمز الحرف
    علامة العطف & &amp; &#38;
    علامة الاقتباس المفردة ' &apos; &#39;
    علامة الاقتباس المزدوجة " &quot; &#34;
    علامة &quot;أكبر من&quot; > &gt; &#62;
    علامة &quot;أقل من&quot; < &lt; &#60;

نتائج XML لطلبات البحث العادية والمتقدمة

بحث عادي/متقدم: نموذج طلب بحث ونتيجة XML

هذا النموذج من طلب "بحث الويب" يطلب 10 نتائج (num=10) عن عبارة البحث "سوسر" (q=socer)، وهي الكلمة "كرة القدم" تمت تهجئتها عمدًا في هذا المثال).

http://www.google.com/search?
q=socer
&hl=en
&start=10
&num=10
&output=xml
&client=google-csbe
&cx=00255077836266642015:u-scht7a-8i

يعرض هذا الطلب نتيجة XML أدناه. لاحظ أن هناك عدة تعليقات في نتيجة XML للإشارة إلى الموضع الذي لا المتضمنة في النتيجة.

<?xml version="1.0" encoding="ISO-8859-1" standalone="no" ?>

<GSP VER="3.2">
<TM>0.452923</TM>
<Q>socer</Q>
<PARAM name="cx" value="00255077836266642015:u-scht7a-8i" original_value="00255077836266642015%3Au-scht7a-8i"/>
<PARAM name="hl" value="en" original_value="en"/>
<PARAM name="q" value="socer" original_value="socer"/>
<PARAM name="output" value="xml" original_value="xml"/>
<PARAM name="client" value="google-csbe" original_value="google-csbe"/>
<PARAM name="num" value="10" original_value="10"/>
<Spelling>
<Suggestion q="soccer"><b><i>soccer</i></b></Suggestion>
</Spelling>
<Context>
<title>Sample Vacation CSE</title>
<Facet>
<FacetItem>
<label>restaurants</label>
<anchor_text>restaurants</anchor_text>
</FacetItem>
<FacetItem>
<label>wineries</label>
<anchor_text>wineries</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>golf_courses</label>
<anchor_text>golf courses</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>hotels</label>
<anchor_text>hotels</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>nightlife</label>
<anchor_text>nightlife</anchor_text>
</FacetItem>
</Facet>
<Facet>
<FacetItem>
<label>soccer_sites</label>
<anchor_text>soccer sites</anchor_text>
</FacetItem>
</Facet>
</Context>
<RES SN="1" EN="10">
<M>6080</M>
/*
* The FI tag after the comment indicates that the result
* set has been filtered. If the number of results were exact, the
* FI tag would be replaced by an XT tag in the same format.
*/
<FI />
<NB>
/*
* Since the request is for the first page of results, the PU tag,
* which contains a link to the previous page of search results,
* is not included in this XML result. If the sample result did include
* a previous page of results, it would be listed here, in the same format
* as the NU tag on the following line
*/
<NU>/search?q=socer&hl=en&lr=&ie=UTF-8&output=xml&client=test&start=10&sa=N</NU>
</NB>
<R N="1">
<U>http://www.soccerconnection.net/</U>
<UE>http://www.soccerconnection.net/</UE>
<T>SoccerConnection.net</T>
<CRAWLDATE>May 21, 2007</CRAWLDATE>
<S><b>soccer</b>; players; coaches; ball; world cup;<b>...</b></S>
<Label>transcodable_pages</Label>
<Label>accessible</Label>
<Label>soccer_sites</Label>
<LANG>en</LANG>
<HAS>
<DI>
<DT>SoccerConnection.net</DT>
<DS>Post your <b>soccer</b> resume directly on the Internet.</DS>
</DI>
<L/>
<C SZ="8k" CID="kWAPoYw1xIUJ"/>
<RT/>
</HAS>
</R>
/*
* The result includes nine more results, each enclosed by an R tag.
*/
</RES>
</GSP>

البحث العادي/المتقدم: علامات XML

استجابات XML لطلبات البحث العادية والبحث المتقدم الطلبات تستخدم نفس مجموعة علامات XML. يتم عرض علامات XML هذه في مثال XML أعلاه والموضح في الجداول أدناه.

يتم سرد علامات XML أدناه أبجديًا حسب اسم العلامة، يتضمن تعريف العلامة وصفًا للعلامة، مثال يعرض كيفية ظهور العلامة في نتيجة XML وتنسيق العلامة المحتوى. إذا كانت العلامة هي علامة فرعية لعلامة XML أخرى أو إذا كانت العلامة تحتوي على علامات فرعية أو سمات خاصة بها، يتم توفير هذه المعلومات أيضًا في جدول تعريف العلامة.

قد يتم عرض بعض الرموز بجوار بعض العلامات الفرعية في التعريفات أدناه. ستجد أدناه هذه الرموز ومعانيها:

؟ = علامة فرعية اختيارية
* = صفر أو أكثر من مثيلات العلامة الفرعية
+ = واحد أو أكثر من مثيلات العلامة الفرعية
أ ب د (ح) 1 L ش لا ش س ر جنوب X

anchor_text
التعريف

تحدد العلامة &lt;anchor_text&gt; النص الذي التي يجب عليك عرضها للمستخدمين لتحديد تحسين علامة مرتبطة بمجموعة نتائج بحث. نظرًا لأن تسميات التصفية تستبدل الأحرف غير الأبجدية الرقمية بشرطات سفلية، فلا يجوز عرض قيمة العلامة <label> في واجهة المستخدم. بدلاً من ذلك، يجب عليك عرض قيمة العلامة &lt;anchor_text&gt;.

مثال <Anchor_text>الغولف دورات تدريبية</Anchor_text>
علامة فرعية لـ FacetItem
تنسيق المحتوى النص

حظر
التعريف

تضم هذه العلامة محتوى القالب في سطر النص لنتيجة العرض الترويجي. وتتضمّن كل مجموعة علامات فرعية T وU وL. إذا كانت العلامة T غير فارغة، هذا يعني أنّ العبارة تتضمّن نصًا. في حين تشير علامتا U وL غير الفارغة إلى أنّ المجموعة تحتوي على رابط (يتم تحديد عنوان URL في العلامة الفرعية U ونص الرابط في العلامة الفرعية L).

العلامات الفرعية T وU وL
علامة فرعية لـ BODY_LINE
تنسيق المحتوى ما مِن لاعبين

BODY_LINE
التعريف

تضم هذه العلامة محتويات سطر في نص النتيجة التي يتم الترويج لها. يتألّف كل سطر من عدّة علامات حظر تحتوي إمّا على نص معيّن أو على رابط يتضمّن عنوان URL ونص رابط.

العلامات الفرعية حظر*
علامة فرعية لـ SL_MAIN
تنسيق المحتوى ما مِن لاعبين

C
التعريف

تشير العلامة &lt;C&gt; إلى أن خدمة WebSearch استرداد نسخة مخزّنة مؤقتًا من عنوان URL لنتيجة البحث هذا. لا يمكنك استرداد الصفحات المخزّنة مؤقتًا من خلال XML API، ولكن يمكنك إعادة توجيه المستخدمين إلى www.google.com لهذا الغرض المحتوى.

السمات
الاسم التنسيق الوصف
جنوب شرق نص (عدد صحيح + "k") تقديم حجم النسخة المخزَّنة مؤقتًا نتيجة البحث بالكيلوبايت ("k").
CID النص يحدد مستندًا في ذاكرة التخزين المؤقت في Google. لجلب المستند من ذاكرة التخزين المؤقت، أرسل عبارة بحث تم إنشاؤها التالي:
cache:CIDtext:escapedURL

يتوفّر عنوان URL الذي تم تخطّيه في علامة UE.

مثال <C SZ="6k" CID=&quot;kvOXK_cYSSgJ&quot; />
علامة فرعية لـ لديه
تنسيق المحتوى ما مِن لاعبين

شهادة C2C
التعريف تشير العلامة <C2C> إلى أن تشير النتيجة إلى صفحة باللغة الصينية التقليدية. هذه العلامة تظهر فقط في حال اختيار المبسّطة والتقليدية تم تفعيل البحث الصيني. اطّلِع على تعريف معلَمة طلب البحث c2coff للحصول على مزيد من المعلومات حول طريقة التفعيل وتعطيل هذه الميزة.
تنسيق المحتوى النص

السياق
التعريف

تضم العلامة &lt;Context&gt; قائمة من تصنيفات التصفية المرتبطة بمجموعة من نتائج البحث.

مثال &lt;Context&gt;
العلامات الفرعية title وFacet
تنسيق المحتوى الحاوية

تاريخ الزحف
التعريف

تحدد العلامة &lt;CRAWLDATE&gt; التاريخ الذي تم الزحف إلى الصفحة لآخر مرة. لا يتم عرض CRAWLDATE لكل صفحة نتائج بحث.

مثال <CRAWLDATE>21 مايو، 2005</CRAWLDATE>
علامة فرعية لـ ر
تنسيق المحتوى النص

التنفيذ الذاتي (DI)
التعريف

تضم علامة &lt;DI&gt; مشروع الدليل المفتوح. معلومات الفئة (ODP) لنتيجة بحث واحدة.

مثال &lt;DI&gt;
العلامات الفرعية DT؟, DS؟
علامة فرعية لـ لديه
تنسيق المحتوى ما مِن لاعبين

DS
التعريف

وتوفر العلامة &lt;DS&gt; الملخص المدرج فئة واحدة في دليل ODP.

مثال <DS>نشر &lt;b&gt;soccer&lt;/b&gt; مباشرةً على الإنترنت.</DS>
علامة فرعية لـ التنفيذ الذاتي
تنسيق المحتوى نص (قد يحتوي على HTML)

شجرة أجهزة (DT)
التعريف

توفر العلامة &lt;DT&gt; عنوان صفحة ويب واحدة مدرجة في دليل ODP.

مثال &lt;DT&gt;SoccerConnection.net&lt;/DT&gt;
علامة فرعية لـ التنفيذ الذاتي
تنسيق المحتوى نص (قد يحتوي على HTML)

الواجهة
التعريف

تتضمن العلامة <Facet> مجموعة منطقية من علامات &lt;FacetItem&gt;. يمكنك إنشاء هذه المجموعات باستخدام محرك البحث المبرمَج تنسيق مواصفات XML للمحرك إذا لم تقم بإنشاء هذه التجميع، تظهر results_xml_tag_Context><Context> العلامة سوف يحتوي على إلى أربع علامات <Facet>. سيتم تجميع العناصر ضمن كل علامة <Facet> لأغراض العرض، ولكن قد لا يكون لها سبب منطقي العلاقة.

مثال <الواجهة>
العلامات الفرعية FacetItem+ وtitle+
علامة فرعية لـ السياق
تنسيق المحتوى الحاوية

FacetItem
التعريف

تضم العلامة &lt;FacetItem&gt; معلومات. حول علامة تصفية مرتبطة بمجموعة من نتائج البحث.

مثال &lt;FacetItem&gt;
العلامات الفرعية label وanchor_text+
علامة فرعية لـ الواجهة
تنسيق المحتوى FacetItem

FI
التعريف تعمل العلامة &lt;FI&gt; كعلامة تشير إلى ما إذا كان قد تم إجراء تصفية المستندات للبحث. الاطّلاع على قسم الفلترة التلقائية من هذا المستند للحصول على مزيد من المعلومات حول نتائج بحث Google والفلاتر.
مثال <FI />
علامة فرعية لـ دقة
تنسيق المحتوى ما مِن لاعبين

GSP
التعريف

تتيح العلامة &lt;GSP&gt; تشمل جميع البيانات التي يتم إرجاعها في نتائج بحث Google XML. "GSP" CANNOT TRANSLATE وهو اختصار لـ "بروتوكول بحث Google".

السمات
الاسم التنسيق الوصف
أبدًا نص (عدد صحيح) تحدد السمة VER إصدار ناتج نتائج البحث. تشير رسالة الأشكال البيانية إصدار الإخراج الحالي هو "3.2".
مثال <GSP VER="3.2">
العلامات الفرعية PARAMQ، RES؟، TM
تنسيق المحتوى ما مِن لاعبين

يحتوي على
التعريف تضم العلامة &lt;HAS&gt; معلومات حول أي بحث خاص مَعلمات الطلبات المتوافقة مع عنوان URL معيّن

ملاحظة: تعريف <HAS> إنّ WebSearch أكثر تقييدًا من DTD.

العلامات الفرعية DI؟, L؟, ج؟, RT؟
علامة فرعية لـ ر

ISURL
التعريف يعرض محرّك بحث Google العلامة &lt;ISURL&gt; إذا كان طلب البحث المرتبط عنوان URL
علامة فرعية لـ GSP
تنسيق المحتوى ما مِن لاعبين

L
التعريف ظهور العلامة &lt;L&gt; يشير إلى أنّ خدمة "بحث الويب" يمكنها العثور على مواقع إلكترونية أخرى ذات روابط إلى عنوان URL لنتيجة البحث هذه. وللعثور على مثل هذه المواقع، يمكنك استخدام عبارة طلب البحث الخاصة link:.
علامة فرعية لـ لديه
تنسيق المحتوى ما مِن لاعبين

التصنيف
التعريف

تحدد العلامة <label> تصنيف تصفية. يمكنك استخدامها لفلترة نتائج البحث التي تظهر لك للاستخدام تصنيف تصفية، أضِف السلسلة more:[[label tag value]] إلى قيمة المَعلمة q في طلب HTTP إلى Google على النحو التالي: كما هو موضح في المثال التالي. يُرجى ملاحظة أن هذه القيمة يجب تخطي عنوان URL قبل إرسال طلب البحث إلى Google.

This example uses the refinement label golf_courses to
filter search results about Palm Springs:
q=Palm+Springs+more:golf_courses

The URL-escaped version of this query is:
q=Palm+Springs+more%3Agolf_courses

ملاحظة: لا تتطابق العلامة <label> مع العلامة &lt;Label&gt; التي تحدد تصنيف تصفية بعنوان URL محدد في نتائج البحث الخاصة بك.

مثال &lt;label&gt;golf_courses&lt;/label&gt;
علامة فرعية لـ FacetItem
تنسيق المحتوى النص

LANG
التعريف

تضم العلامة &lt;LANG&gt; أفضل تخمينات Google حول لغة نتيجة البحث.

مثال <lang>ar</ae>
علامة فرعية لـ ر
تنسيق المحتوى النص

M
التعريف

تحدد العلامة &lt;M&gt; الإجمالي المقدّر عدد نتائج البحث.

ملاحظة: قد لا يكون هذا التقدير دقيقًا.

مثال <M>16200000</M>
علامة فرعية لـ دقة
تنسيق المحتوى النص

NB
التعريف

تتضمن العلامة &lt;NB&gt; معلومات التنقل - روابط إلى الصفحة التالية من نتائج البحث أو الصفحة السابقة من نتائج البحث - لمجموعة النتائج.

ملاحظة: هذه العلامة متوفّرة فقط. إذا توفرت نتائج أخرى.

مثال &lt;NB&gt;
العلامات الفرعية NU؟, PU؟
علامة فرعية لـ دقة
تنسيق المحتوى ما مِن لاعبين

NU
التعريف

تتضمن العلامة &lt;NU&gt; رابطًا نسبيًا الصفحة التالية من نتائج البحث.

مثال <NU>/search?q=flowers&num=10&hl=ar&ie=UTF-8
&output=xml&client=test&start=10</NU>
علامة فرعية لـ نيو برونزويك
تنسيق المحتوى نص (عنوان URL نسبي)

المعلمة
التعريف

العلامة &lt;PARAM&gt; تحدِّد معلمة إدخال تم إرسالها في طلب HTTP المرتبط مع نتيجة XML. يتم تضمين معلومات حول المعلمة في تصنيفات العلامات - الاسم والقيمة والقيمة_الأصلية - وستكون هناك علامة PARAM واحدة لكل معلمة تم إرسالها في طلب HTTP.

السمات
الاسم التنسيق الوصف
name النص اسم معلَمة الإدخال
value HTML نسخة الإدخال بتنسيق HTML .
original_value النص الإصدار الأصلي تجاوز عنوان URL لقيمة مَعلمة الإدخال.
مثال <PARAM name="cr" value=&quot;countryNZ&quot; original_value="countryNZ" />
علامة فرعية لـ GSP
تنسيق المحتوى متقدّم

PU
التعريف

توفّر العلامة &lt;PU&gt; رابطًا نسبيًا الصفحة السابقة من نتائج البحث.

مثال <PU>/search?q=flowers&num=10&hl=ar&output=xml
&client=test&start=10</PU>
علامة فرعية لـ نيو برونزويك
تنسيق المحتوى نص (عنوان URL نسبي)

سين
التعريف

تحدد العلامة &lt;Q&gt; طلب البحث المقدمة في طلب HTTP المرتبط بنتيجة XML.

مثال

<Q>بيتزا</Q>

علامة فرعية لـ GSP
تنسيق المحتوى النص

R
التعريف

تضم العلامة &lt;R&gt; تفاصيل نتيجة بحث فردية.

ملاحظة: تعريف العلامة <R> إنّ WebSearch أكثر تقييدًا من DTD.

السمات
الاسم التنسيق الوصف
N نص (عدد صحيح) يشير إلى الفهرس (المستند إلى 1) لهذا نتيجة البحث.
MIME النص يشير إلى نوع MIME للبحث نتيجته.
العلامات الفرعية U وUE وT؟، CRAWLDATE، S?, LANG?, لديه
علامة فرعية لـ دقة

مقياس تفاعل القراء
التعريف

تضم العلامة &lt;RES&gt; مجموعة من العناصر الفردية نتائج البحث وتفاصيل حول تلك النتائج.

السمات
الاسم التنسيق الوصف
السنغال نص (عدد صحيح) يشير إلى فهرس (المستند إلى 1) تم عرض أول نتيجة بحث في مجموعة النتائج هذه.
EN نص (عدد صحيح) يشير إلى الفهرس (المستند إلى 1) لآخر نتيجة البحث التي تم عرضها في مجموعة النتائج هذه.
مثال <RES SN="1" EN="10">
العلامات الفرعية M، FI؟, XT؟، NB؟, ر*
علامة فرعية لـ GSP
تنسيق المحتوى ما مِن لاعبين

S
التعريف

تتضمن العلامة &lt;S&gt; مقتطفًا لبحث تعرض عبارات طلب البحث مميزة بخط غامق. فواصل الأسطر هي تضمينها في المقتطف لالتفاف النص بشكل مناسب.

مثال <S>واشنطن (CNN) -- عرض سعر لإنهاء خلاف في مجلس الشيوخ حول الرئيس &lt;b&gt;Bush&#39;s&lt;/b&gt; والاختيارات القضائية السماح لخمسة مرشحين بالتقدم إلى التصويت النهائي مع المحافظة على &lt;b&gt;...&lt;b&gt;...&lt;/b&gt;<S>
علامة فرعية لـ ر
تنسيق المحتوى نص (HTML)

SL_MAIN
التعريف

تضم هذه العلامة محتوى نتيجة العرض الترويجي. استخدِمه لتحليل العروض الترويجية. ويتم تضمين نص الرابط وعنوان URL لرابط العنوان في العلامتَين الفرعيتَين T وU على التوالي. يتم تضمين سطور النص الأساسي والروابط في العلامات الفرعية BODY_LINE.

العلامات الفرعية BODY_LINET، U
علامة فرعية لـ SL_RESULTS
تنسيق المحتوى ما مِن لاعبين

SL_RESULTS
التعريف

علامة حاوية للنتائج التي تم الترويج لها. ستظهر إحدى هذه السمات عند تقديم عرض ترويجي في نتائج البحث. تحتوي العلامة الفرعية SL_MAIN على بيانات النتيجة الرئيسية.

العلامات الفرعية SL_MAIN*
علامة فرعية لـ ر
تنسيق المحتوى ما مِن لاعبين

التهجئة
التعريف

تضم العلامة <Spelling> بديلاً اقتراح إملائي لطلب البحث الذي تم إرساله. تظهر هذه العلامة فقط على الصفحة الأولى من نتائج البحث. تتوفّر اقتراحات الإملاء في الإنجليزية والصينية واليابانية والكورية.

ملاحظة: لن تعرض Google سوى الاقتراحات الإملائية طلبات البحث التي تكون فيها قيمة المَعلمة gl الأحرف الصغيرة.

مثال <تدقيق إملائي>
العلامات الفرعية اقتراح
علامة فرعية لـ GSP
تنسيق المحتوى ما مِن لاعبين

اقتراح
التعريف تحتوي العلامة &lt;Suggestion&gt; على اقتراح إملائي بديل لطلب البحث الذي تم إرساله. يمكنك استخدام صفحة العلامة لاقتراح تهجئة بديلة لمستخدم البحث. قيمة السمة q هي اقتراح إملائي تم تجاوزه باستخدام عنوان URL يمكنك استخدامه كعبارة طلب بحث
السمات
الاسم التنسيق الوصف
q النص تحدد السمة q نسخة تجاوز عنوان URL من الاقتراح الإملائي.
مثال <اقتراح
علامة فرعية لـ الإملاء
تنسيق المحتوى نص (HTML)

T
التعريف تتضمن العلامة &lt;T&gt; العنوان. النتيجة.
مثال <T>الساحل الشرقي لأميسي مطعم بيتزا</T>
علامة فرعية لـ ر
تنسيق المحتوى نص (HTML)

title
التعريف

وهي علامة ثانوية لـ &lt;Context&gt;، تحتوي العلامة &lt;Context&gt; على اسم "محرك البحث المبرمَج".

توفّر العلامة <title> عنوانًا لمجموعة من الواجهات، وهي تابعة لـ <Facet>.

مثال

كعنصر فرعي لـ <Context>: <title>My Search Engine&lt;/title&gt;

كطفل لـ <Facet>: <title>facet العنوان</title>

علامة فرعية لـ السياق والواجهة
تنسيق المحتوى النص

TM
التعريف

تحدد العلامة &lt;TM&gt; وقت الخادم الإجمالي اللازمة لعرض نتائج البحث، ويتم قياسها بالثواني.

مثال <TM>0.100445</TM>
علامة فرعية لـ GSP
تنسيق المحتوى نص (رقم النقطة العائم)

هدف
التعريف توفّر العلامة &lt;TT&gt; طلب بحث نصيحة.
مثال <TT>&lt;i&gt;نصيحة: لمعظم المتصفحات، فإن الضغط على مفتاح Return يؤدي إلى الحصول على النتائج نفسها التي تظهر عند النقر على زر "بحث".&lt;/i&gt;</TT>
علامة فرعية لـ GSP

U
التعريف توفر العلامة &lt;U&gt; عنوان URL نتيجة البحث.
مثال &lt;U&gt;http://www.dominos.com/&lt;/U&gt;
علامة فرعية لـ ر
تنسيق المحتوى النص (عنوان URL المطلق)

UD
التعريف

توفر العلامة &lt;UD&gt; معرّف IDN (اسم النطاق الدولي) لنتيجة البحث. تسمح القيمة من النطاقات التي سيتم عرضها باستخدام اللغات المحلية. على سبيل المثال، يمكن فك ترميز عنوان URL بترميز IDN http://www.%E8%8A%B1%E4%BA%95.com وعرضه على النحو التالي http://www.花鮨.com. لن يتم تضمين علامة &lt;UD&gt; هذه إلا في نتائج البحث لـ الطلبات التي تضمنت المعلمة ud.

ملاحظة: هذه ميزة تجريبية.

مثال &lt;UD&gt;http://www.%E8%8A%B1%E4%BA%95.com/&lt;/UD&gt;
علامة فرعية لـ ر
تنسيق المحتوى نص (عنوان URL بترميز IDN)

UE
التعريف توفر العلامة &lt;UE&gt; عنوان URL نتيجة البحث. يتم تخطي عنوان URL لتكون القيمة مناسبة. لتمريرها كمعلمة طلب بحث في عنوان URL
مثال &lt;UE&gt;http://www.dominos.com/&lt;/UE&gt;
علامة فرعية لـ ر
تنسيق المحتوى نص (عنوان URL الذي يتضمن حروف إلغاء عنوان URL)

XT
التعريف تشير العلامة &lt;XT&gt; إلى أن العدد الإجمالي المقدّر للنتائج، كما هو محدد بواسطة العلامة M، يمثل العدد الدقيق إجمالي عدد النتائج. راجع زر التشغيل التلقائي قسم "الفلترة" في هذا المستند للحصول على مزيد من التفاصيل.
مثال <XT />
علامة فرعية لـ دقة
تنسيق المحتوى ما مِن لاعبين


نتائج XML لطلبات البحث عن الصور

يطلب نموذج طلب الصورة هذا 5 نتائج (العدد=5) عن عبارة البحث "قرد" (q=monkey).

http://www.google.com/cse?
  searchtype=image
  &num=2
  &q=monkey
  &client=google-csbe
  &output=xml_no_dtd
  &cx=00255077836266642015:u-scht7a-8i

يعرض هذا الطلب نتيجة XML أدناه.


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

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

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

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

بحث الصور: علامات XML

يعرض الجدول أدناه علامات XML الإضافية المستخدمة في ردود XML لطلبات البحث عن الصور.

قد يتم عرض بعض الرموز بجوار بعض العلامات الفرعية في التعريفات أدناه. ستجد أدناه هذه الرموز ومعانيها:

؟ = علامة فرعية اختيارية
* = صفر أو أكثر من مثيلات العلامة الفرعية
+ = واحد أو أكثر من مثيلات العلامة الفرعية

RG
التعريف

تتضمن العلامة &lt;RG&gt; تفاصيل نتيجة بحث صور فردية.

السمات
الاسم التنسيق الوصف
N نص (عدد صحيح) يشير إلى الفهرس (المستند إلى 1) لهذا نتيجة البحث.
MIME النص يشير إلى نوع MIME للبحث نتيجته.
علامة فرعية لـ دقة
روسيا
التعريف

تتضمن العلامة <RU tag> تفاصيل كل نتيجة من نتائج البحث عن الصور.

علامة فرعية لـ ر