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

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

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

نظرة عامة

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

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

تنسيق طلب WebSearch

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

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

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

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

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

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

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

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

يتم إرسال عبارة طلب البحث إلى خدمة WebSearch باستخدام المَعلمة q. ومن أمثلة طلب البحث ما يلي:

q=horses+cows+pigs

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

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

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

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

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

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

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

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

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

يطلب هذا الطلب أول 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 لاستبعاد أي مستندات تحتوي على كلمة "Yankees" من نتائج البحث (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

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

c2coff
الوصف

Optional. تعمل المَعلمة c2coff على تفعيل ميزة البحث بالصينية المبسّطة والتقليدية أو إيقافها.

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

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

العميل
الوصف

مَعلمة مطلوبة. يجب ضبط المعلَمة client على google-csbe.
أمثلة q=google&client=google-csbe

cr
الوصف

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

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

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

راجِع قسم قيم مَعلمة البلد (cr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة.
أمثلة q=Frodo&cr=countryNZ

cx
الوصف

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

للعثور على قيمة المعلَمة cx، انتقِل إلى لوحة التحكّم > علامة التبويب "الرموز" في محرّكك، ويمكنك العثور عليها في منطقة النص ضمن "لصق هذا الرمز في الصفحة التي تريد أن يظهر فيها مربّع البحث". ستظهر نتائج البحث على صفحة تستضيفها Google."
أمثلة q=Frodo&cx=00255077836266642015:u-scht7a-8i

filter
الوصف

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

إنّ القيمة التلقائية للمَعلمة filter هي 1، ما يعني أنّ الميزة مفعّلة. والقيم الصالحة لهذه المعلَمة هي:

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

ملاحظة: يطبّق محرّك بحث Google تلقائيًا الفلترة على كل نتائج البحث لتحسين جودة هذه النتائج.
أمثلة q=google&filter=0

gl
الوصف

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

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

يعزز هذا الطلب المستندات المكتوبة في المملكة المتحدة في نتائج بحث الويب:
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 (اللغة المحدودة) تحصر نتائج البحث بالمستندات المكتوبة بلغة معيّنة.

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

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

راجِع القسم قيَم مجموعة اللغة (lr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة.
أمثلة q=Frodo&lr=lang_en

num
الوصف

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

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

ملاحظة: إذا كان إجمالي عدد نتائج البحث أقل من العدد المطلوب، سيتم عرض جميع نتائج البحث المتاحة.
أمثلة q=google&num=10

oe
الوصف

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

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

راجِع القسم مخططات ترميز الأحرف للحصول على قائمة بقيم oe المحتملة.
أمثلة q=google&ie=utf8&oe=utf8

الإنتاج
الوصف

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

القيمة تنسيق الناتج
xml_no_dtd لن تتضمّن نتائج XML عبارة DOCTYPE. (يُنصح به)
xml ستتضمّن نتائج XML مرجع DTD من Google. سيحدِّد السطر الثاني من النتيجة نوع تعريف المستند (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

عودة
الوصف

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

http://www.花井鮨.com

القيم الصالحة لهذه المَعلمة هي 1 (الخيار التلقائي)، وهذا يعني أنّ نتيجة XML يجب أن تتضمّن عناوين URL بترميز IDN و0، أي أنّ نتيجة XML يجب ألا تتضمن عناوين URL بترميز IDN. في حال ضبط المَعلمة 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. على الصورة، يكون اسم كل مَعلمة بحث متقدّم مكتوبًا بنص red داخل الحقل الذي تتطابق معه هذه المَعلمة أو بجانبه.



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

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

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

مصطلحات طلبات البحث الخاصة

تتيح خدمة WebSearch من 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، يجب إدراج عبارة البحث OR، بأحرف كبيرة، بين كل عبارة في السلسلة.

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

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

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

إدخال المستخدم: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)
  • Lotus 1-2-3 (wk1، wk2، wk3، wk4، wk5، wki، wks، wku)
  • Lotus WordPro (lwp)
  • ما اكتبه (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (مستند)
  • Microsoft Works (wks، wps، wdb)
  • كتابة Microsoft (wri)
  • تنسيق Rich Text (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)
  • Lotus 1-2-3 (wk1، wk2، wk3، wk4، wk5، wki، wks، wku)
  • Lotus WordPro (lwp)
  • ما اكتبه (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (ppt)
  • Microsoft Word (مستند)
  • Microsoft Works (wks، wps، wdb)
  • كتابة Microsoft (wri)
  • تنسيق Rich Text (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" و "scotland" في عناوين URL، ولكنّها لن تشترط ظهور هاتين الكلمتَين بأي ترتيب معيّن أو الفصل بينهما بشرطة مائلة.

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

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


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

تسترد عبارة طلب البحث info: معلومات عامة حول عنوان URL طالما أنّ عنوان 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 مع كل طلب.

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

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

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

ترميز الأحرف

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

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

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

  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

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

توفّر خدمة WebSearch من Google عددًا من الطرق لفلترة نتائج البحث:

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

نتائج XML

نتائج بحث XML من Google

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

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

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

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

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

<!DOCTYPE GSP SYSTEM "google.dtd">

يمكنك الوصول إلى أحدث DTD على http://www.google.com/google.dtd.

يُرجى العلم أنّ بعض الميزات في 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

يطلب نموذج طلب WebSearch هذا الحصول على 10 نتائج (num=10) حول عبارة البحث "socer" (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 أخرى أو إذا كانت العلامة تتضمن علامات فرعية أو سمات خاصة بها، يتم تقديم هذه المعلومات أيضًا في جدول تعريف العلامة.

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

? = علامة فرعية اختيارية
* = صفر أو أكثر من مثيلات العلامة الفرعية
+ = مثيل واحد أو أكثر من العلامة الفرعية
أ B C د ح 1 خ م لا ش س R إعداد T X

anchor_text
التعريف

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

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

حظر
التعريف

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

BODY_LINE
التعريف

تضم هذه العلامة محتوى سطر في نص النتيجة المروَّج لها. يتألف كل سطر أساسي من عدة علامات BLOCK، والتي تحتوي إما على نص أو رابط يحتوي على عنوان URL ونص الرابط.
العلامات الفرعية حظر*
علامة فرعية لـ SL_MAIN
تنسيق المحتوى ما مِن لاعبين

C
التعريف

تشير العلامة <C> إلى أنّ خدمة WebSearch يمكنها استرداد نسخة مخبأة من عنوان URL لنتيجة البحث هذه. ولا يمكنك استرداد الصفحات المخزّنة مؤقتًا من خلال واجهة برمجة تطبيقات XML، ولكن يمكنك إعادة توجيه المستخدمين إلى www.google.com من أجل هذا المحتوى.
السمات
الاسم التنسيق الوصف
SZ نص (عدد صحيح + "k") يوفّر هذا الحقل حجم النسخة المخزّنة مؤقتًا من نتيجة البحث بالكيلوبايت ("k").
الرقم التعريفي للعميل النص يحدد مستند في ذاكرة التخزين المؤقت لدى Google. لجلب المستند من ذاكرة التخزين المؤقت، أرسِل عبارة بحث تم إنشاؤها على النحو التالي:
cache:CIDtext:escapedURL

يتوفر عنوان URL ذي حروف الإلغاء في علامة UE.
مثال <C SZ="6k" CID="kvOXK_cYSSgJ" />
علامة فرعية لـ HAS
تنسيق المحتوى ما مِن لاعبين

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

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

تتضمن علامة <Context> قائمة بتصنيفات التصفية المرتبطة بمجموعة من نتائج البحث.
مثال <Context>
العلامات الفرعية title وFacet+
تنسيق المحتوى الحاوية

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

تحدد العلامة <CRAWLDATE> تاريخ آخر عملية زحف إلى الصفحة. لا يتم عرض CRAWLDATE لكل صفحة من صفحات نتائج البحث.
مثال <CRAWLDATE>21 أيار (مايو) 2005</CRAWLDATE>
علامة فرعية لـ R
تنسيق المحتوى النص

DI
التعريف

تتضمن العلامة <DI> معلومات فئة مشروع الدليل المفتوح (ODP) لنتيجة بحث واحدة.
مثال <DI>
العلامات الفرعية DT؟, DS؟
علامة فرعية لـ HAS
تنسيق المحتوى ما مِن لاعبين

DS
التعريف

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

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

توفّر العلامة <DT> عنوانًا لفئة واحدة مُدرَجة في دليل ODP.
مثال <DT>SoccerConnection.net</DT>
علامة فرعية لـ DI
تنسيق المحتوى نص (قد يحتوي على HTML)

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

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

FacetItem
التعريف

تتضمن علامة <FacetItem> معلومات حول علامة التصفية المرتبطة بمجموعة من نتائج البحث.
مثال <FacetItem>
العلامات الفرعية label وanchor_text+
علامة فرعية لـ الواجهة
تنسيق المحتوى FacetItem

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

GSP
التعريف

تضم العلامة <GSP> جميع البيانات المعروضة في نتائج بحث XML من Google. "GSP" هو اختصار لـ "بروتوكول بحث Google".
السمات
الاسم التنسيق الوصف
الأخير نص (عدد صحيح) تحدد السمة VER نسخة إخراج نتائج البحث. إصدار الإخراج الحالي هو "3.2".
مثال <GSP VER="3.2">
العلامات الفرعية PARAM+، Q، RES؟، العلامة التجارية
تنسيق المحتوى ما مِن لاعبين

HAS
التعريف تتضمن العلامة <HAS> معلومات حول أي مَعلمات طلبات بحث خاصة متاحة لعنوان URL معيّن.

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

العلامات الفرعية DI?, L?, C?, RT?
علامة فرعية لـ R

معرّف ISURL
التعريف يعرض محرّك بحث Google العلامة <ISURL> إذا كان طلب البحث المرتبط عبارة عن عنوان URL.
علامة فرعية لـ إعلانات ترويجية على الإنترنت (GSP)
تنسيق المحتوى ما مِن لاعبين

L
التعريف يشير ظهور العلامة <L> إلى أنّ خدمة WebSearch يمكنها العثور على مواقع إلكترونية أخرى تتضمّن روابط تؤدّي إلى عنوان URL لنتيجة البحث هذه. للعثور على هذه المواقع، عليك استخدام عبارة طلب البحث الخاصة link:.
علامة فرعية لـ HAS
تنسيق المحتوى ما مِن لاعبين

label
التعريف

تحدد العلامة <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> عن العلامة <Label> التي تحدد علامة تصفية مرتبطة بعنوان URL معيّن في نتائج البحث.
مثال <label>دورات الغولف</label>
علامة فرعية لـ FacetItem
تنسيق المحتوى النص

اللغة الإنجليزية
التعريف

تتضمن العلامة <LANG> أفضل تخمين من Google للغة نتيجة البحث.
مثال <LANG>en</LANG>
علامة فرعية لـ R
تنسيق المحتوى النص

ن
التعريف

تحدد العلامة <M> العدد الإجمالي المقدّر لنتائج البحث.

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

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

NB
التعريف

تتضمن العلامة <NB> معلومات التنقل الخاصة بمجموعة النتائج، وهي روابط تؤدي إلى الصفحة التالية من نتائج البحث أو الصفحة السابقة من نتائج البحث.

ملاحظة: لا تظهر هذه العلامة إلّا إذا كان هناك المزيد من النتائج.
مثال <NB>
العلامات الفرعية NU؟, PU؟
علامة فرعية لـ المعدلات
تنسيق المحتوى ما مِن لاعبين

النرويج
التعريف

تتضمن العلامة <NU> رابطًا نسبيًا يؤدي إلى الصفحة التالية من نتائج البحث.
مثال <NU>/search?q=flowers&num=10&hl=ar&ie=UTF-8
&output=xml&client=test&start=10</NU>
علامة فرعية لـ ملاحظة
تنسيق المحتوى نص (عنوان URL نسبي)

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

تحدّد العلامة <PARAM> معلَمة إدخال تم إرسالها في طلب HTTP والمرتبطة بنتيجة XML. ويتم تضمين معلومات عن المَعلمة في سمات العلامة، وهي الاسم والقيمة والقيمة الأصلية، وسيتم تضمين علامة PARAM واحدة لكل مَعلمة يتم إرسالها في طلب HTTP.
السمات
الاسم التنسيق الوصف
name النص اسم مَعلمة الإدخال
value HTML هي نسخة بتنسيق HTML لقيمة معلمة الإدخال.
original_value النص الإصدار الأصلي الذي تم تجاوز عنوان URL له لقيمة مَعلمة الإدخال
مثال <PARAM name="cr" value="countryNZ" original_value="countryNZ" />
علامة فرعية لـ إعلانات ترويجية على الإنترنت (GSP)
تنسيق المحتوى متقدّم

بولي يورثان متلدّن بالحرارة
التعريف

توفّر العلامة <PU> رابطًا نسبيًا يؤدي إلى الصفحة السابقة من نتائج البحث.
مثال <PU>/search?q=flowers&num=10&hl=ar&output=xml
&client=test&start=10</PU>
علامة فرعية لـ ملاحظة
تنسيق المحتوى نص (عنوان URL نسبي)

سين
التعريف

تحدد العلامة <Q> طلب البحث الذي تم إرساله في طلب HTTP المرتبط بنتيجة XML.
مثال

<Q>pizza</Q>
علامة فرعية لـ إعلانات ترويجية على الإنترنت (GSP)
تنسيق المحتوى النص

R
التعريف

تتضمن العلامة <R> تفاصيل نتيجة بحث فردية.

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

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

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

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

S
التعريف

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

SL_MAIN
التعريف

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

SL_RESULTS
التعريف

علامة حاوية للنتائج التي تم الترويج لها سيظهر أحدهما عندما يكون لديك عرض ترويجي في نتائج البحث. تحتوي العلامة الفرعية SL_MAIN على بيانات النتيجة الرئيسية.
العلامات الفرعية SL_MAIN*
علامة فرعية لـ R
تنسيق المحتوى ما مِن لاعبين

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

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

ملاحظة: لن يعرض محرّك بحث Google سوى الاقتراحات الإملائية لطلبات البحث التي تكون فيها قيمة المَعلمة gl بأحرف صغيرة.
مثال <Spelling>
العلامات الفرعية اقتراح
علامة فرعية لـ إعلانات ترويجية على الإنترنت (GSP)
تنسيق المحتوى ما مِن لاعبين

الاقتراح
التعريف تتضمن العلامة <Suggestion> اقتراحًا إملائيًا بديلاً لطلب البحث الذي تم إرساله. يمكنك استخدام محتوى العلامة لاقتراح التهجئة البديلة على مستخدم البحث. قيمة السمة q هي الاقتراح الإملائي الذي يتضمّن أحرف إلغاء لعنوان URL والذي يمكنك استخدامه كعبارة طلب بحث.
السمات
الاسم التنسيق الوصف
q النص تحدد السمة q الإصدار تم تجاوز عنوان URL الخاص بالاقتراح الإملائي.
مثال <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion>
علامة فرعية لـ التهجئة
تنسيق المحتوى نص (HTML)

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

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

تحتوي العلامة <title> على اسم محرك البحث المبرمَج الخاص بك، وهي علامة فرعية لـ <Context>.

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

في سنّ <Context>: <title>محرك البحث الخاص بي</title>

الأطفال لـ <Facet>: <title>facet title</title>
علامة فرعية لـ السياق، واجهة
تنسيق المحتوى النص

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

تحدد العلامة <TM> إجمالي الوقت اللازم للخادم لعرض نتائج البحث، ويتم قياس ذلك بالثواني.
مثال <TM>0.100445</TM>
علامة فرعية لـ إعلانات ترويجية على الإنترنت (GSP)
تنسيق المحتوى نص (رقم عائم)

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

U
التعريف توفر العلامة <U> عنوان URL لنتيجة البحث.
مثال <U>http://www.dominos.com/</U>
علامة فرعية لـ R
تنسيق المحتوى نص (عنوان URL كامل)

UD
التعريف

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

ملاحظة: هذه ميزة تجريبية.
مثال <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
علامة فرعية لـ R
تنسيق المحتوى نص (عنوان URL بترميز IDN)

UE
التعريف توفّر العلامة <UE> عنوان URL الخاص بنتيجة البحث. تتضمّن القيمة أحرف إلغاء لعنوان URL، كي تكون مناسبة للتمرير كمَعلمة طلب بحث في عنوان URL.
مثال <UE>http://www.dominos.com/</UE>
علامة فرعية لـ R
تنسيق المحتوى نص (عنوان URL يشتمل على أحرف إلغاء)

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


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

يطالبك طلب الصورة النموذجي بالحصول على 5 نتائج (num=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> تفاصيل نتيجة بحث صور فردية.
السمات
الاسم التنسيق الوصف
N نص (عدد صحيح) تشير هذه السمة إلى فهرس نتيجة البحث هذه (المستندة إلى رقم 1).
بروتوكول MIME النص تشير هذه السمة إلى نوع MIME لنتيجة البحث.
علامة فرعية لـ المعدلات
روسيا
التعريف

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