تشير هذه الصفحة إلى إصدار XML من واجهة برمجة تطبيقات JSON للبحث المخصص، والتي تتوفر فقط عملاء Google Site Search.
- نظرة عامة
- تنسيق طلب محرك البحث المبرمَج
- نتائج 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 التي تمثّل المَعلمة الفريدة
رقم تعريف المحرّك
معلمات الطلب الأكثر استخدامًا بخلاف المعلمات المذكورة أعلاه هي:
نماذج طلبات بحث الويب
تعرض الأمثلة أدناه بعض طلبات 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 على تمكين أو تعطيل المعلمة المبسطة والبحث الصينية التقليدية. القيمة التلقائية لهذه المَعلمة هي
|
||||||
أمثلة | q=google&c2coff=1 |
عميل | |
---|---|
الوصف | مَعلمة مطلوبة. يجب ضبط المَعلمة |
أمثلة | q=google&client=google-csbe |
كوستاريكا | |
---|---|
الوصف | Optional. تقصر المعلمة تحدِّد خدمة "بحث الويب من Google" بلد المستند من خلال التحليل:
راجِع مَعلمة البلد (cr). القيم للاطّلاع على قائمة بالقيم الصالحة لهذه المَعلمة. |
أمثلة | q=Frodo&cr=countryNZ |
تجربة العملاء | |
---|---|
الوصف | مَعلمة مطلوبة. تحدد المعلمة |
أمثلة | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
تصفية | |||||||
---|---|---|---|---|---|---|---|
الوصف | Optional. يتم تفعيل المَعلمة filter أو لإيقاف التصفية التلقائية لنتائج بحث Google. راجع قسم التصفية التلقائية لهذا لمزيد من المعلومات حول فلاتر نتائج البحث من Google. القيمة التلقائية للمَعلمة
ملاحظة: تطبِّق Google تلقائيًا الفلترة على جميع نتائج البحث لتحسين جودة تلك النتائج. |
||||||
أمثلة | q=google&filter=0 |
gl | |
---|---|
الوصف | Optional. قيمة المعلمة تحديد قيمة مَعلمة |
أمثلة | يعزز هذا الطلب المستندات المكتوبة في المملكة المتحدة باللغة
نتائج بحث الويب: |
hl | |
---|---|
الوصف | Optional. تحدد المعلمة يمكنك الاطّلاع على قسم لغات الواجهة الخاصة بـ تدويل طلبات البحث وعرض النتائج لمزيد من المعلومات ولغات الواجهة المعتمدة للاطّلاع على قائمة باللغات المتاحة |
أمثلة | يستهدف هذا الطلب إعلانات النبيذ باللغة الفرنسية. (Vin هو المصطلح الفرنسي "النبيذ"). q=vin&ip=10.10.10.10&ad=w5&hl=fr |
جودة عالية | |
---|---|
الوصف | Optional. تُلحق المَعلمة |
أمثلة | يبحث هذا الطلب عن "بيتزا" و"الجبن". التعبير هو نفسه
|
ie | |
---|---|
الوصف | Optional. تحدد المعلمة راجِع القسم ترميز الأحرف للاطّلاع على مناقشة الحالات التي قد تحتاج فيها إلى استخدام هذه المَعلمة. راجع ترميز الأحرف
قسم المخططات للاطّلاع على قائمة قيم |
أمثلة | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
الوصف | Optional. تحصر مَعلمة تحدِّد خدمة "بحث الويب من Google" لغة المستند من خلال التحليل:
يمكنك الاطّلاع على اللغة ( |
أمثلة | q=Frodo&lr=lang_en |
الرقم | |
---|---|
الوصف | Optional. تحدد المعلمة قيمة ملاحظة: إذا كان إجمالي عدد نتائج البحث أقل أكبر من العدد المطلوب من النتائج، فستتغير جميع نتائج البحث المتاحة وإرجاعه. |
أمثلة | q=google&num=10 |
EE | |
---|---|
الوصف | Optional. تحدد المعلمة راجِع القسم ترميز الأحرف للاطّلاع على مناقشة الحالات التي قد تحتاج فيها إلى استخدام هذه المَعلمة. راجع ترميز الأحرف
قسم المخططات للاطّلاع على قائمة قيم |
أمثلة | q=google&ie=utf8&oe=utf8 |
output | |||||||
---|---|---|---|---|---|---|---|
الوصف | مَعلمة مطلوبة. تحدّد المَعلمة
|
||||||
أمثلة | output=xml_no_dtd |
q | |
---|---|
الوصف | Optional. تحدد المعلمة هناك أيضًا عدد من مصطلحات الاستعلام الخاصة التي يمكن
كجزء من معلَمة تتضمن لوحة تحكم "بحث Google" تقريرًا بالجزء العلوي
طلب بحث تم إرساله باستخدام مَعلمة ملاحظة: القيمة المحدّدة للمَعلمة q يجب أن يتخطى عنوان URL. |
أمثلة | q=vacation&as_oq=london+paris |
وضع آمن | |||||||||
---|---|---|---|---|---|---|---|---|---|
الوصف | Optional. تشير معلمة
الاطّلاع على مقالة فلترة محتوى البالغين مع البحث الآمن لمزيد من التفاصيل حول هذه الميزة. |
||||||||
أمثلة | q=adult&safe=high |
بدء | |
---|---|
الوصف | Optional. تشير المعلمة تعمل المعلمة |
أمثلة | start=10 |
ترتيب | |
---|---|
الوصف | Optional. تُحدِّد المَعلمة |
أمثلة |
|
uds | |
---|---|
الوصف | Optional. تشير المعلمة http://www.花井鮨.com إنّ القيم الصالحة لهذه المَعلمة هي إذا تم ضبط المَعلمة http://www.xn--elq438j.com. ملاحظة: هذه ميزة تجريبية. |
أمثلة | q=google&ud=1 |
بحث متقدم
إنّ مَعلمات طلب البحث الإضافية المدرَجة أسفل الصورة ذات صلة بطلبات البحث المتقدّم. عند إرسال بحث متقدم، تظهر قيم عدة معلَمات (مثل as_eq، as_epq وas_oq وما إلى ذلك) جميعها في طلب البحث مصطلحات البحث هذا. تعرض الصورة صفحة "البحث المتقدم" من Google. في الصورة، سيظهر اسم كل معلمة البحث المتقدم مكتوبة بنص أحمر داخل أو بجانب الحقل على الصفحة الذي تتجاوب معه هذه المعلمة.
معلمات طلب البحث المتقدم
as_dt | |
---|---|
الوصف | Optional. تتحكم معلمة |
أمثلة | as_dt=i,as_dt=e |
as_epq | |
---|---|
الوصف | Optional. تحدد المعلمة |
أمثلة | as_epq=abraham+lincoln |
as_eq | |
---|---|
الوصف | Optional. تحدد المعلمة |
أمثلة |
|
as_lq | |
---|---|
الوصف | Optional. تحدد المعلمة |
أمثلة |
|
as_nlo | |
---|---|
الوصف | Optional. تحدد المعلمة |
أمثلة | في ما يلي نطاق بحث يتراوح بين 5 و10، بشكل شامل:
|
as_nhi | |
---|---|
الوصف | Optional. تحدد المعلمة |
أمثلة | في ما يلي نطاق بحث يتراوح بين 5 و10، بشكل شامل:
|
as_oq | |
---|---|
الوصف | Optional. توفر المعلمة |
أمثلة |
|
as_q | |
---|---|
الوصف | Optional. توفر المعلمة |
أمثلة |
|
as_qdr | |
---|---|
الوصف | Optional. معلَمة
يطلب |
أمثلة |
يطلب هذا المثال نتائج من العام الماضي:
يطلب هذا المثال نتائج من آخر 10 أيام:
|
as_sitesearch | |
---|---|
الوصف | Optional. مَعلمة |
أمثلة |
|
عبارات طلبات البحث الخاصة
يتيح بحث الويب من Google استخدام العديد من مصطلحات الاستعلام الخاصة التي
الوصول إلى إمكانات إضافية لمحرك بحث Google. هذه
تضمين عبارات طلب البحث الخاصة في قيمة معلَمة الطلب q. مثل مصطلحات الاستعلام الأخرى،
يجب أن تكون عبارات البحث الخاصة تتضمن إلغاء عنوان URL. حاسمة
عدد عبارات طلب البحث الخاصة التي تحتوي على نقطتين (:). هذه الشخصية
يجب أن يتضمن حروف إلغاء عنوان URL أيضًا؛ وقيمته التي تتضمن حروف إلغاء عنوان URL هي %3A
.
الروابط الخلفية [link:] | |
---|---|
الوصف | عبارة طلب البحث إصدار يمكنك أيضًا استخدام طلب as_lq
لإرسال طلب ملاحظة: لا يمكنك تحديد أي عبارات طلب بحث أخرى عندما
باستخدام |
أمثلة |
|
منطقية 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 |
استبعاد عبارة طلب البحث [-] | |
---|---|
الوصف | تؤدّي عبارة طلب البحث "استبعاد ( إصدار تكون عبارة استبعاد طلب البحث مفيدة عندما تحتوي عبارة البحث على عدد أكبر من أكثر من معنى واحد. على سبيل المثال، يمكن أن تشير كلمة "باس" يمكن أن تعرض نتائج سواء عن الأسماك أو الموسيقى. إذا كنت تبحث عن وثائق حول يمكنك استبعاد مستندات حول الموسيقى من نتائج البحث باستخدام عبارة استبعاد طلب البحث. يمكنك أيضًا استخدام طلب as_eq لاستبعاد المستندات التي تطابق كلمة أو عبارة معيّنة من نتائج البحث. |
أمثلة | البيانات التي أدخلها المستخدم: bass -music عبارة طلب البحث: q=bass+%2Dmusic |
استبعاد نوع الملف [ -filetype: ] | |
---|---|
الوصف | تستثني عبارة طلب البحث إصدار ملاحظة: يمكنك استبعاد عدة مواقع
أنواع الملفات من نتائج البحث من خلال إضافة المزيد من طلبات البحث تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:
يمكن إضافة أنواع ملفات إضافية في المستقبل. تحديث التي يمكن العثور عليها دائمًا في الأسئلة الشائعة حول نوع ملف Google. |
أمثلة | يعرض هذا المثال المستندات التي تشير إلى "Google" لكن ذلك
ليست مستندات PDF: يعرض هذا المثال المستندات التي تشير إلى "Google" لكن
باستثناء مستندات PDF وWord: |
تصفية نوع الملف [ filetype: ] | |
---|---|
الوصف | تحصر عبارة طلب البحث إصدار يمكنك حصر إمكانية البحث.
النتائج إلى المستندات التي تتطابق مع أحد امتدادات الملفات العديدة عن طريق إضافة
بشكل افتراضي، تضمين مستندات بأي امتداد ملف تشمل أنواع الملفات المتوافقة مع محرّك بحث Google ما يلي:
يمكن إضافة أنواع ملفات إضافية في المستقبل. تحديث التي يمكن العثور عليها دائمًا في الأسئلة الشائعة حول نوع ملف Google. |
أمثلة | يعرض هذا المثال مستندات PDF التي تشير إلى "Google": يعرض هذا المثال مستندات PDF وWord التي تشير إلى
"Google": |
تضمين عبارة طلب البحث [+] | |
---|---|
الوصف | يحدد مصطلح طلب البحث الخاص بالتضمين (+) أن الكلمة أو العبارة في جميع المستندات المضمَّنة في نتائج البحث. لاستخدام تضمين مصطلح طلب بحث، فستبدأ بتمهيد الكلمة أو العبارة التي يجب تم تضمينها في جميع نتائج البحث مع علامة "+" (علامة زائد). إصدار يجب استخدام |
أمثلة | البيانات التي أدخلها المستخدم: Star Wars Episode +I عبارة طلب البحث: q=Star+Wars+Episode+%2BI |
البحث عن روابط فقط، جميع العبارات [ allinlinks: ] | |
---|---|
الوصف | تتطلب عبارة طلب البحث إذا كان طلب البحث يتضمّن طلب البحث إصدار |
أمثلة | البيانات التي أدخلها المستخدم:allinlinks: Google search عبارة طلب البحث: q=allinlinks%3A+Google+search |
البحث بالعبارات | |
---|---|
الوصف | تسمح لك عبارة طلب بحث العبارة (") بالبحث عن عن طريق تضمين العبارات بين علامتي اقتباس أو لربطها بواصلات. إصدار تعتبر عمليات البحث بالعبارات مفيدة بشكل خاص إذا كنت تبحث للاقتباسات المشهورة أو أسماء العلم. يمكنك أيضًا استخدام طلب as_epq. لإرسال بحث بالعبارات. |
أمثلة | البيانات التي أدخلها المستخدم:"Abraham Lincoln" عبارة طلب البحث: q=%22Abraham+Lincoln%22 |
البحث في النص فقط، جميع العبارات [allintext:] | |
---|---|
الوصف | تتطلب عبارة طلب البحث إذا كان طلب البحث يتضمّن طلب البحث إصدار |
أمثلة | يحدد هذا المثال أن الكلمات
"Google" و"بحث" أن يظهر في النص الأساسي لكل المستندات المضمّنة
في نتائج البحث: إدخال المستخدم: allintext:Google search عبارة طلب البحث: q=allintext%3AGoogle+search |
بحث العنوان، مصطلح واحد [intitle:] | |
---|---|
الوصف | تحصر عبارة طلب البحث ملاحظة: يمكنك تحديد المزيد
أكثر من كلمة واحدة يجب تضمينها في عنوان المستند عن طريق
عبارة طلب البحث إصدار |
أمثلة | ويحدّد هذا المثال أن كلمة "Google" يجب أن يظهر في
وعناوين أي مستندات في نتائج البحث، بالإضافة إلى
"بحث" يجب أن تظهر في أي مكان في العناوين أو عناوين URL أو الروابط أو النص الأساسي
من هذه المستندات: |
البحث في العنوان، جميع العبارات [allintitle:] | |
---|---|
الوصف | تحصر عبارة طلب البحث ملاحظة: يتساوى وضع إصدار |
أمثلة | يحدد هذا المثال أن الكلمات "Google" و"بحث"
في عناوين أي مستندات في نتائج البحث: |
البحث عن عنوان URL، عبارة واحدة [inurl:] | |
---|---|
الوصف | تحصر عبارة طلب البحث طلب البحث إصدار |
أمثلة | ويحدّد هذا المثال أن كلمة "Google" يجب أن يظهر في
وعناوين URL لأي مستندات في نتائج البحث، بالإضافة إلى كلمة "بحث"
في أي مكان في العناوين أو عناوين URL أو الروابط أو النص الأساسي لتلك العناوين
المستندات: |
البحث عن عنوان URL، كل العبارات [allinurl:] | |
---|---|
الوصف | تحصر عبارة طلب البحث تتجاهل عبارة طلب البحث إصدار |
أمثلة | يحدد هذا المثال أن الكلمات "Google" و"بحث"
في عناوين URL لأي مستندات في نتائج البحث: |
معلومات مستند الويب [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. لعرض صور من نوع محدد. القيم المسموح بها هي: |
أمثلة | q=google&as_filetype=png |
imgsz | |
---|---|
الوصف | Optional. لعرض صور بحجم محدد، حيث يمكن أن يكون الحجم واحدًا مما يلي:
|
أمثلة | q=google&as_filetype=png&imgsz=icon |
نوع الصورة | |
---|---|
الوصف | Optional. عرض صور من نوع معين يمكن أن تكون أيًا مما يلي:
|
أمثلة | q=google&as_filetype=png&imgtype=photo |
imgc | |
---|---|
الوصف | Optional. لعرض صور بالأبيض والأسود أو بتدرج الرمادي أو ملونة:
|
أمثلة | q=google&as_filetype=png&imgc=gray |
imgcolor | |
---|---|
الوصف | Optional. لعرض صور لون بارز معين:
|
أمثلة | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
الوصف | Optional. الفلاتر المُستنِدة إلى الترخيص. وتشمل القيم المسموح بها ما يلي:
|
أمثلة | 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 والقيمة المنطقية قسم "عوامل التشغيل" للاطّلاع على مناقشة كاملة حول استخدام هذه والمشغلات.
البحث باللغة الصينية المبسّطة والتقليدية
الصينية المبسطة والصينية التقليدية هما متغيران للكتابة باللغة الصينية. يمكن كتابة نفس المفهوم بشكل مختلف في لكل صيغة. بناءً على طلب بحث في إحدى الصيغ، يحدد يمكن لخدمة "بحث الويب" عرض نتائج تشتمل على صفحات في كليهما مختلفة.
لاستخدام هذه الميزة:
- ضبط مَعلمة طلب c2coff على 0
أو - نفّذ أيًا مما يلي:
يوضح المثال التالي معلَمات طلب البحث التي تريد تضمينها في طلب النتائج. في كل من الصينية المبسّطة والتقليدية (لاحظ أن المعلومات الإضافية المطلوبة، مثل باعتباره العميل، لم يتم تضمينه في المثال).
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
- تنسيق 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
المستندات العادية هذه الأحرف: هذه الأحرف
وإعادة إنتاجها في الجدول أدناه:
حرف النماذج التي تم تجاهلها الكيان رمز الحرف علامة العطف & & & علامة الاقتباس المفردة ' ' ' علامة الاقتباس المزدوجة " " " علامة "أكبر من" > > > علامة "أقل من" < < <
نتائج 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 | |
---|---|
التعريف | تحدد العلامة <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 | |
---|---|
التعريف | تضم هذه العلامة محتويات سطر في نص النتيجة التي يتم الترويج لها. يتألّف كل سطر من عدّة علامات حظر تحتوي إمّا على نص معيّن أو على رابط يتضمّن عنوان URL ونص رابط. |
العلامات الفرعية | حظر* |
علامة فرعية لـ | SL_MAIN |
تنسيق المحتوى | ما مِن لاعبين |
C | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
التعريف | تشير العلامة <C> إلى أن خدمة WebSearch
استرداد نسخة مخزّنة مؤقتًا من عنوان URL لنتيجة البحث هذا. لا يمكنك
استرداد الصفحات المخزّنة مؤقتًا من خلال XML API، ولكن يمكنك إعادة توجيه المستخدمين
إلى www.google.com لهذا الغرض
المحتوى. |
|||||||||
السمات |
|
|||||||||
مثال | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
علامة فرعية لـ | لديه | |||||||||
تنسيق المحتوى | ما مِن لاعبين |
شهادة C2C | |
---|---|
التعريف | تشير العلامة <C2C> إلى أن تشير النتيجة إلى صفحة باللغة الصينية التقليدية. هذه العلامة تظهر فقط في حال اختيار المبسّطة والتقليدية تم تفعيل البحث الصيني. اطّلِع على تعريف معلَمة طلب البحث c2coff للحصول على مزيد من المعلومات حول طريقة التفعيل وتعطيل هذه الميزة. |
تنسيق المحتوى | النص |
السياق | |
---|---|
التعريف | تضم العلامة <Context> قائمة من تصنيفات التصفية المرتبطة بمجموعة من نتائج البحث. |
مثال | <Context> |
العلامات الفرعية | title وFacet |
تنسيق المحتوى | الحاوية |
تاريخ الزحف | |
---|---|
التعريف | تحدد العلامة <CRAWLDATE> التاريخ الذي
تم الزحف إلى الصفحة لآخر مرة. لا يتم عرض |
مثال | <CRAWLDATE>21 مايو، 2005</CRAWLDATE> |
علامة فرعية لـ | ر |
تنسيق المحتوى | النص |
التنفيذ الذاتي (DI) | |
---|---|
التعريف | تضم علامة <DI> مشروع الدليل المفتوح. معلومات الفئة (ODP) لنتيجة بحث واحدة. |
مثال | <DI> |
العلامات الفرعية | DT؟, DS؟ |
علامة فرعية لـ | لديه |
تنسيق المحتوى | ما مِن لاعبين |
DS | |
---|---|
التعريف | وتوفر العلامة <DS> الملخص المدرج فئة واحدة في دليل ODP. |
مثال | <DS>نشر <b>soccer</b> مباشرةً على الإنترنت.</DS> |
علامة فرعية لـ | التنفيذ الذاتي |
تنسيق المحتوى | نص (قد يحتوي على HTML) |
شجرة أجهزة (DT) | |
---|---|
التعريف | توفر العلامة <DT> عنوان صفحة ويب واحدة مدرجة في دليل ODP. |
مثال | <DT>SoccerConnection.net</DT> |
علامة فرعية لـ | التنفيذ الذاتي |
تنسيق المحتوى | نص (قد يحتوي على HTML) |
الواجهة | |
---|---|
التعريف | تتضمن العلامة <Facet> مجموعة منطقية من علامات <FacetItem>. يمكنك إنشاء هذه المجموعات باستخدام محرك البحث المبرمَج تنسيق مواصفات XML للمحرك إذا لم تقم بإنشاء هذه التجميع، تظهر results_xml_tag_Context><Context> العلامة سوف يحتوي على إلى أربع علامات <Facet>. سيتم تجميع العناصر ضمن كل علامة <Facet> لأغراض العرض، ولكن قد لا يكون لها سبب منطقي العلاقة. |
مثال | <الواجهة> |
العلامات الفرعية | FacetItem+ وtitle+ |
علامة فرعية لـ | السياق |
تنسيق المحتوى | الحاوية |
FacetItem | |
---|---|
التعريف | تضم العلامة <FacetItem> معلومات. حول علامة تصفية مرتبطة بمجموعة من نتائج البحث. |
مثال | <FacetItem> |
العلامات الفرعية | label وanchor_text+ |
علامة فرعية لـ | الواجهة |
تنسيق المحتوى | FacetItem |
FI | |
---|---|
التعريف | تعمل العلامة <FI> كعلامة تشير إلى ما إذا كان قد تم إجراء تصفية المستندات للبحث. الاطّلاع على قسم الفلترة التلقائية من هذا المستند للحصول على مزيد من المعلومات حول نتائج بحث Google والفلاتر. |
مثال | <FI /> |
علامة فرعية لـ | دقة |
تنسيق المحتوى | ما مِن لاعبين |
GSP | |||||||
---|---|---|---|---|---|---|---|
التعريف | تتيح العلامة <GSP> تشمل جميع البيانات التي يتم إرجاعها في نتائج بحث Google XML. "GSP" CANNOT TRANSLATE وهو اختصار لـ "بروتوكول بحث Google". |
||||||
السمات |
|
||||||
مثال | <GSP VER="3.2"> | ||||||
العلامات الفرعية | PARAM+، Q، RES؟، TM | ||||||
تنسيق المحتوى | ما مِن لاعبين |
يحتوي على | |
---|---|
التعريف | تضم العلامة <HAS>
معلومات حول أي بحث خاص
مَعلمات الطلبات المتوافقة مع عنوان URL معيّن
ملاحظة: تعريف <HAS> إنّ WebSearch أكثر تقييدًا من DTD. |
العلامات الفرعية | DI؟, L؟, ج؟, RT؟ |
علامة فرعية لـ | ر |
ISURL | |
---|---|
التعريف | يعرض محرّك بحث Google العلامة <ISURL> إذا كان طلب البحث المرتبط عنوان URL |
علامة فرعية لـ | GSP |
تنسيق المحتوى | ما مِن لاعبين |
L | |
---|---|
التعريف | ظهور العلامة <L> يشير إلى أنّ خدمة "بحث الويب" يمكنها العثور على مواقع إلكترونية أخرى ذات روابط إلى عنوان URL لنتيجة البحث هذه. وللعثور على مثل هذه المواقع، يمكنك استخدام عبارة طلب البحث الخاصة link:. |
علامة فرعية لـ | لديه |
تنسيق المحتوى | ما مِن لاعبين |
التصنيف | |
---|---|
التعريف | تحدد العلامة <label> تصنيف تصفية. يمكنك استخدامها لفلترة نتائج البحث التي تظهر لك للاستخدام تصنيف تصفية، أضِف السلسلة more:[[label tag value]] إلى قيمة المَعلمة q في طلب HTTP إلى Google على النحو التالي: كما هو موضح في المثال التالي. يُرجى ملاحظة أن هذه القيمة يجب تخطي عنوان URL قبل إرسال طلب البحث إلى Google. This example uses the refinement label golf_courses to ملاحظة: لا تتطابق العلامة <label> مع العلامة <Label> التي تحدد تصنيف تصفية بعنوان URL محدد في نتائج البحث الخاصة بك. |
مثال | <label>golf_courses</label> |
علامة فرعية لـ | FacetItem |
تنسيق المحتوى | النص |
LANG | |
---|---|
التعريف | تضم العلامة <LANG> أفضل تخمينات Google حول لغة نتيجة البحث. |
مثال | <lang>ar</ae> |
علامة فرعية لـ | ر |
تنسيق المحتوى | النص |
M | |
---|---|
التعريف | تحدد العلامة <M> الإجمالي المقدّر عدد نتائج البحث. ملاحظة: قد لا يكون هذا التقدير دقيقًا. |
مثال | <M>16200000</M> |
علامة فرعية لـ | دقة |
تنسيق المحتوى | النص |
NB | |
---|---|
التعريف | تتضمن العلامة <NB> معلومات التنقل - روابط إلى الصفحة التالية من نتائج البحث أو الصفحة السابقة من نتائج البحث - لمجموعة النتائج. ملاحظة: هذه العلامة متوفّرة فقط. إذا توفرت نتائج أخرى. |
مثال | <NB> |
العلامات الفرعية | NU؟, PU؟ |
علامة فرعية لـ | دقة |
تنسيق المحتوى | ما مِن لاعبين |
NU | |
---|---|
التعريف | تتضمن العلامة <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. |
||||||||||||
السمات |
|
||||||||||||
مثال | <PARAM name="cr" value="countryNZ" original_value="countryNZ" /> | ||||||||||||
علامة فرعية لـ | GSP | ||||||||||||
تنسيق المحتوى | متقدّم |
PU | |
---|---|
التعريف | توفّر العلامة <PU> رابطًا نسبيًا الصفحة السابقة من نتائج البحث. |
مثال | <PU>/search?q=flowers&num=10&hl=ar&output=xml &client=test&start=10</PU> |
علامة فرعية لـ | نيو برونزويك |
تنسيق المحتوى | نص (عنوان URL نسبي) |
سين | |
---|---|
التعريف | تحدد العلامة <Q> طلب البحث المقدمة في طلب HTTP المرتبط بنتيجة XML. |
مثال | <Q>بيتزا</Q> |
علامة فرعية لـ | GSP |
تنسيق المحتوى | النص |
R | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
التعريف | تضم العلامة <R> تفاصيل نتيجة بحث فردية. ملاحظة: تعريف العلامة <R> إنّ WebSearch أكثر تقييدًا من DTD. |
|||||||||
السمات |
|
|||||||||
العلامات الفرعية | U وUE وT؟، CRAWLDATE، S?, LANG?, لديه | |||||||||
علامة فرعية لـ | دقة |
مقياس تفاعل القراء | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
التعريف | تضم العلامة <RES> مجموعة من العناصر الفردية نتائج البحث وتفاصيل حول تلك النتائج. |
|||||||||
السمات |
|
|||||||||
مثال | <RES SN="1" EN="10"> | |||||||||
العلامات الفرعية | M، FI؟, XT؟، NB؟, ر* | |||||||||
علامة فرعية لـ | GSP | |||||||||
تنسيق المحتوى | ما مِن لاعبين |
S | |
---|---|
التعريف | تتضمن العلامة <S> مقتطفًا لبحث تعرض عبارات طلب البحث مميزة بخط غامق. فواصل الأسطر هي تضمينها في المقتطف لالتفاف النص بشكل مناسب. |
مثال | <S>واشنطن (CNN) -- عرض سعر لإنهاء خلاف في مجلس الشيوخ حول الرئيس <b>Bush's</b> والاختيارات القضائية السماح لخمسة مرشحين بالتقدم إلى التصويت النهائي مع المحافظة على <b>...<b>...</b><S> |
علامة فرعية لـ | ر |
تنسيق المحتوى | نص (HTML) |
SL_MAIN | |
---|---|
التعريف | تضم هذه العلامة محتوى نتيجة العرض الترويجي. استخدِمه لتحليل العروض الترويجية. ويتم تضمين نص الرابط وعنوان URL لرابط العنوان في العلامتَين الفرعيتَين T وU على التوالي. يتم تضمين سطور النص الأساسي والروابط في العلامات الفرعية BODY_LINE. |
العلامات الفرعية | BODY_LINE*، T، U |
علامة فرعية لـ | SL_RESULTS |
تنسيق المحتوى | ما مِن لاعبين |
SL_RESULTS | |
---|---|
التعريف | علامة حاوية للنتائج التي تم الترويج لها. ستظهر إحدى هذه السمات عند تقديم عرض ترويجي في نتائج البحث. تحتوي العلامة الفرعية SL_MAIN على بيانات النتيجة الرئيسية. |
العلامات الفرعية | SL_MAIN* |
علامة فرعية لـ | ر |
تنسيق المحتوى | ما مِن لاعبين |
التهجئة | |
---|---|
التعريف | تضم العلامة <Spelling> بديلاً اقتراح إملائي لطلب البحث الذي تم إرساله. تظهر هذه العلامة فقط على الصفحة الأولى من نتائج البحث. تتوفّر اقتراحات الإملاء في الإنجليزية والصينية واليابانية والكورية. ملاحظة: لن تعرض Google سوى الاقتراحات الإملائية طلبات البحث التي تكون فيها قيمة المَعلمة gl الأحرف الصغيرة. |
مثال | <تدقيق إملائي> |
العلامات الفرعية | اقتراح |
علامة فرعية لـ | GSP |
تنسيق المحتوى | ما مِن لاعبين |
اقتراح | |||||||
---|---|---|---|---|---|---|---|
التعريف | تحتوي العلامة <Suggestion> على اقتراح إملائي بديل لطلب البحث الذي تم إرساله. يمكنك استخدام صفحة العلامة لاقتراح تهجئة بديلة لمستخدم البحث. قيمة السمة q هي اقتراح إملائي تم تجاوزه باستخدام عنوان URL يمكنك استخدامه كعبارة طلب بحث | ||||||
السمات |
|
||||||
مثال | <اقتراح | ||||||
علامة فرعية لـ | الإملاء | ||||||
تنسيق المحتوى | نص (HTML) |
T | |
---|---|
التعريف | تتضمن العلامة <T> العنوان. النتيجة. |
مثال | <T>الساحل الشرقي لأميسي مطعم بيتزا</T> |
علامة فرعية لـ | ر |
تنسيق المحتوى | نص (HTML) |
title | |
---|---|
التعريف | وهي علامة ثانوية لـ <Context>، تحتوي العلامة <Context> على اسم "محرك البحث المبرمَج". توفّر العلامة <title> عنوانًا لمجموعة من الواجهات، وهي تابعة لـ <Facet>. |
مثال | كعنصر فرعي لـ <Context>: <title>My Search Engine</title> كطفل لـ <Facet>: <title>facet العنوان</title> |
علامة فرعية لـ | السياق والواجهة |
تنسيق المحتوى | النص |
TM | |
---|---|
التعريف | تحدد العلامة <TM> وقت الخادم الإجمالي اللازمة لعرض نتائج البحث، ويتم قياسها بالثواني. |
مثال | <TM>0.100445</TM> |
علامة فرعية لـ | GSP |
تنسيق المحتوى | نص (رقم النقطة العائم) |
هدف | |
---|---|
التعريف | توفّر العلامة <TT> طلب بحث نصيحة. |
مثال | <TT><i>نصيحة: لمعظم المتصفحات، فإن الضغط على مفتاح Return يؤدي إلى الحصول على النتائج نفسها التي تظهر عند النقر على زر "بحث".</i></TT> |
علامة فرعية لـ | GSP |
U | |
---|---|
التعريف | توفر العلامة <U> عنوان URL نتيجة البحث. |
مثال | <U>http://www.dominos.com/</U> |
علامة فرعية لـ | ر |
تنسيق المحتوى | النص (عنوان URL المطلق) |
UD | |
---|---|
التعريف | توفر العلامة <UD> معرّف 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> |
علامة فرعية لـ | ر |
تنسيق المحتوى | نص (عنوان URL بترميز IDN) |
UE | |
---|---|
التعريف | توفر العلامة <UE> عنوان URL نتيجة البحث. يتم تخطي عنوان URL لتكون القيمة مناسبة. لتمريرها كمعلمة طلب بحث في عنوان URL |
مثال | <UE>http://www.dominos.com/</UE> |
علامة فرعية لـ | ر |
تنسيق المحتوى | نص (عنوان URL الذي يتضمن حروف إلغاء عنوان URL) |
XT | |
---|---|
التعريف | تشير العلامة <XT> إلى أن العدد الإجمالي المقدّر للنتائج، كما هو محدد بواسطة العلامة 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 | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
التعريف | تتضمن العلامة <RG> تفاصيل نتيجة بحث صور فردية. |
|||||||||
السمات |
| |||||||||
علامة فرعية لـ | دقة |
روسيا | |
---|---|
التعريف | تتضمن العلامة <RU tag> تفاصيل كل نتيجة من نتائج البحث عن الصور. |
علامة فرعية لـ | ر |