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

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

    <!DOCTYPE GSP SYSTEM "google.dtd">

بحث متقدم

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

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

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

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

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

تعرض الأمثلة أدناه بعض طلبات 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

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

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

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

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

تمكّنك خدمة "بحث الويب من 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" عدة طرق لفلترة نتائج بحثك. النتائج:

• تلقائي فلترة نتائج البحث
• فلترة اللغة والبلد
• تصفية محتوى البالغين باستخدام SafeSearch

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

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

• تنسيق XML من Google النتائج حتى تاريخ الانتهاء
• لمحة عن استجابة XML
• XML نتائج طلبات البحث العادية والمتقدّمة
• البحث العادي/المتقدم: نموذج طلب بحث ونتيجة XML
• البحث العادي/المتقدم: علامات 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 هذه الكيانات مرة أخرى إلى الأحرف المناسبة. إذا لم تحوّل الكيانات بشكل صحيح، على سبيل المثال، يعرض المتصفح الرمز & "&". يتضمن ملف XML المستندات العادية هذه الأحرف: هذه الأحرف وإعادة إنتاجها في الجدول أدناه:

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

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

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

نتائج 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 لطلبات البحث عن الصور.

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