تشير هذه الصفحة إلى إصدار XML من واجهة برمجة التطبيقات Custom Search JSON API المتاحة فقط لعملاء Google Site Search.
- نظرة عامّة
- تنسيق طلب محرك البحث المبرمج
- نتائج XML
نظرة عامة
تتيح خدمة WebSearch من Google لعملاء Google Site Search إمكانية عرض نتائج البحث من Google على مواقعهم الإلكترونية. تستخدم خدمة WebSearch بروتوكولاً بسيطًا مستندًا إلى HTTP لعرض نتائج البحث. ويمكن لمشرفي "بحث Google" التحكّم بشكل كامل في طريقة طلبهم لنتائج البحث وطريقة عرض هذه النتائج للمستخدم النهائي. يصف هذا المستند التفاصيل الفنية لتنسيقات طلبات البحث ونتائجه على Google.
لاسترداد نتائج بحث الويب من Google، يرسل تطبيقك طلب HTTP بسيطًا إلى Google. يعرض محرّك بحث Google بعد ذلك نتائج البحث بتنسيق XML. تتيح لك النتائج بتنسيق XML تخصيص طريقة عرض نتائج البحث.
تنسيق طلب WebSearch
- نظرة عامة على الطلب
- عبارات طلب البحث
- معلَمات الطلب
- أمثلة على طلبات بحث الويب
- تعريفات مَعلمات طلب بحث 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 التي تمثّل المعرّف الفريد للمحرّك
أمّا معلَمات الطلب الأكثر استخدامًا، غير تلك المذكورة أعلاه، فهي:
نماذج طلبات بحث الويب
تعرض الأمثلة أدناه اثنين من طلبات 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 على تفعيل ميزة البحث بالصينية المبسّطة والتقليدية أو إيقافها. إنّ القيمة التلقائية لهذه المَعلمة هي
|
||||||
أمثلة | q=google&c2coff=1 |
العميل | |
---|---|
الوصف | مَعلمة مطلوبة. يجب ضبط المعلَمة |
أمثلة | q=google&client=google-csbe |
cr | |
---|---|
الوصف | Optional. تحصر المَعلمة تحدِّد خدمة WebSearch من Google بلد المستند من خلال تحليل ما يلي:
راجِع قسم قيم مَعلمة البلد (cr) للحصول على قائمة بالقيم الصالحة لهذه المَعلمة. |
أمثلة | q=Frodo&cr=countryNZ |
cx | |
---|---|
الوصف | مَعلمة مطلوبة. تحدّد المعلَمة |
أمثلة | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
filter | |||||||
---|---|---|---|---|---|---|---|
الوصف | 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. إنّ المعلَمة تحدِّد خدمة WebSearch من Google لغة المستند من خلال تحليل ما يلي:
راجِع القسم قيَم مجموعة اللغة ( |
أمثلة | q=Frodo&lr=lang_en |
num | |
---|---|
الوصف | Optional. تحدِّد المعلَمة القيمة التلقائية لـ ملاحظة: إذا كان إجمالي عدد نتائج البحث أقل من العدد المطلوب، سيتم عرض جميع نتائج البحث المتاحة. |
أمثلة | q=google&num=10 |
oe | |
---|---|
الوصف | Optional. تحدّد المَعلمة راجِع القسم ترميز الأحرف للاطّلاع على مناقشة حول متى قد تحتاج إلى استخدام هذه المَعلمة. راجِع القسم مخططات ترميز الأحرف للحصول على قائمة بقيم |
أمثلة | q=google&ie=utf8&oe=utf8 |
الإنتاج | |||||||
---|---|---|---|---|---|---|---|
الوصف | مَعلمة مطلوبة. تحدّد المعلَمة
|
||||||
أمثلة | output=xml_no_dtd |
q | |
---|---|
الوصف | Optional. تحدّد المَعلمة هناك أيضًا عدد من عبارات طلبات البحث الخاصة التي يمكن
استخدامها كجزء من قيمة المعلَمة تتضمّن لوحة تحكّم "بحث Google" تقريرًا بأهم
طلبات البحث التي تم إرسالها باستخدام المَعلمة ملاحظة: يجب أن تتضمّن القيمة المحدّدة للمَعلمة q أحرف إلغاء لعنوان URL. |
أمثلة | q=vacation&as_oq=london+paris |
وضع آمن | |||||||||
---|---|---|---|---|---|---|---|---|---|
الوصف | Optional. تشير المَعلمة
راجِع قسم فلترة المحتوى المخصّص للبالغين باستخدام ميزة "البحث الآمن" للاطّلاع على مزيد من التفاصيل حول هذه الميزة. |
||||||||
أمثلة | q=adult&safe=high |
بدء | |
---|---|
الوصف | Optional. تشير المَعلمة وتعمل المَعلمة |
أمثلة | start=10 |
ترتيب | |
---|---|
الوصف | Optional. تحدّد المعلَمة |
أمثلة |
|
عودة | |
---|---|
الوصف | Optional. تشير المَعلمة http://www.花井鮨.com القيم الصالحة لهذه المَعلمة هي إذا تم ضبط المعلَمة http://www.xn--elq438j.com. ملاحظة: هذه ميزة تجريبية. |
أمثلة | q=google&ud=1 |
البحث المتقدم
إنّ مَعلمات طلبات البحث الإضافية المدرَجة أسفل الصورة ذات صلة بطلبات البحث المتقدّم. عند إجراء بحث متقدم، يتم تضمين قيم عدة معلمات (مثل as_eq وas_epq وas_oq وما إلى ذلك) في عبارات طلب البحث تلك. تعرض الصورة صفحة "البحث المتقدّم" من Google. على الصورة، يكون اسم كل مَعلمة بحث متقدّم مكتوبًا بنص red داخل الحقل الذي تتطابق معه هذه المَعلمة أو بجانبه.
معلمات طلب البحث المتقدم
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. تسمح لك المعلَمة |
أمثلة |
|
مصطلحات طلبات البحث الخاصة
تتيح خدمة WebSearch من Google استخدام العديد من عبارات البحث الخاصة التي تمنح محرك بحث Google إمكانية الوصول إلى المزيد من الإمكانيات. ويجب تضمين عبارات البحث الخاصة هذه في قيمة مَعلمة الطلب q. كما هي الحال مع عبارات طلبات البحث الأخرى،
يجب أن تحتوي عبارات البحث الخاصة على حروف الإلغاء في عنوان URL. يتضمّن عدد
من عبارات طلبات البحث الخاصة علامة نقطتين (:). ويجب أيضًا أن يتضمّن هذا الحرف
أحرف إلغاء لعنوان URL، وقيمته التي تتضمّن أحرف إلغاء لعنوان URL هي %3A
.
روابط الخلفية [link:] | |
---|---|
الوصف | تسترد عبارة طلب البحث إصدار يمكنك أيضًا استخدام معلمة الطلب as_lq
لإرسال طلب ملاحظة: لا يمكنك تحديد أي عبارات بحث أخرى عند استخدام |
أمثلة |
|
بحث منطقي 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 |
استبعاد عبارة طلب البحث [-] | |
---|---|
الوصف | عند استخدام عبارة استبعاد ( إصدار تكون عبارة "استبعاد طلب البحث" مفيدة عندما يكون لعبارة البحث أكثر من معنى واحد. على سبيل المثال، يمكن أن تؤدي كلمة "باس" إلى عرض نتائج حول الأسماك أو الموسيقى. إذا كنت تبحث عن مستندات حول الأسماك، يمكنك استبعاد مستندات عن الموسيقى من نتائج البحث باستخدام عبارة "استبعاد" في طلب البحث. يمكنك أيضًا استخدام مَعلمة الطلب 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 مع كل طلب. |
تدويل الاستعلامات وعرض النتائج
تتيح لك خدمة 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 عرض نتائج تتضمّن صفحات بكلا الصيغتَين.
لاستخدام هذه الميزة:
- اضبط معلَمة الطلب c2coff على 0
- نفّذ أيًا مما يلي:
يوضّح المثال التالي معلَمات طلب البحث التي ستدرجها في طلب للحصول على نتائج باللغتَين الصينية المبسّطة والتقليدية. (يُرجى العِلم بأنّه لا يتم تضمين المعلومات الإضافية المطلوبة، مثل العميل، في المثال).
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
- لمحة عن استجابة XML
- XML نتائج طلبات البحث العادية والمتقدّمة
- البحث العادي/المتقدم: نموذج طلب البحث ونتيجة XML
- البحث العادي/المتقدم: علامات 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 أن يحوّل هذه الكيانات إلى
الأحرف المناسبة. وإذا لم تحوّل الكيانات بشكل صحيح، قد يعرض المتصفّح على سبيل المثال الحرف & على النحو "&".
ويوثق XML
العادي هذه الأحرف، وقد تم نسخ هذه الأحرف
في الجدول أدناه:
حرف النماذج التي تم إلغاؤها الكيان رمز الحرف علامة العطف و & & علامة الاقتباس المفردة ' ' ' علامة الاقتباس المزدوجة " " " علامة "أكبر من" > > > علامة "أقل من" < < <
نتائج 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 من أجل هذا المحتوى. |
|||||||||
السمات |
|
|||||||||
مثال | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
علامة فرعية لـ | HAS | |||||||||
تنسيق المحتوى | ما مِن لاعبين |
C2C | |
---|---|
التعريف | تشير العلامة <C2C> إلى أنّ النتيجة تشير إلى صفحة بلغة الصينية التقليدية. لا تظهر هذه العلامة إلا عند تفعيل بحث اللغة الصينية المبسّطة والتقليدية. يُرجى الاطّلاع على تعريف معلَمة طلب البحث c2coff للحصول على مزيد من المعلومات عن تفعيل هذه الميزة وإيقافها. |
تنسيق المحتوى | النص |
السياق | |
---|---|
التعريف | تتضمن علامة <Context> قائمة بتصنيفات التصفية المرتبطة بمجموعة من نتائج البحث. |
مثال | <Context> |
العلامات الفرعية | title وFacet+ |
تنسيق المحتوى | الحاوية |
تاريخ الزحف | |
---|---|
التعريف | تحدد العلامة <CRAWLDATE> تاريخ آخر عملية زحف إلى الصفحة. لا يتم عرض |
مثال | <CRAWLDATE>21 أيار (مايو) 2005</CRAWLDATE> |
علامة فرعية لـ | R |
تنسيق المحتوى | النص |
DI | |
---|---|
التعريف | تتضمن العلامة <DI> معلومات فئة مشروع الدليل المفتوح (ODP) لنتيجة بحث واحدة. |
مثال | <DI> |
العلامات الفرعية | DT؟, DS؟ |
علامة فرعية لـ | HAS |
تنسيق المحتوى | ما مِن لاعبين |
DS | |
---|---|
التعريف | توفّر العلامة <DS> الملخّص المدرج لفئة واحدة في دليل ODP. |
مثال | <DS>انشر <b>soccer</b> سيرتك الذاتية مباشرةً على الإنترنت.</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". |
||||||
السمات |
|
||||||
مثال | <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 ملاحظة: تختلف العلامة <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. |
||||||||||||
السمات |
|
||||||||||||
مثال | <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. |
|||||||||
السمات |
|
|||||||||
العلامات الفرعية | U وUE وT؟، CRAWLDATE، S؟، العربية?, HAS | |||||||||
علامة فرعية لـ | المعدلات |
مقياس تفاعل القراء | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
التعريف | تتضمن العلامة <RES> مجموعة من نتائج البحث الفردية وتفاصيل حول هذه النتائج. |
|||||||||
السمات |
|
|||||||||
مثال | <RES SN="1" EN="10"> | |||||||||
العلامات الفرعية | M أو FI؟, XT؟، NB؟, R* | |||||||||
علامة فرعية لـ | إعلانات ترويجية على الإنترنت (GSP) | |||||||||
تنسيق المحتوى | ما مِن لاعبين |
S | |
---|---|
التعريف | تتضمن العلامة <S> مقتطفًا لنتيجة بحث يعرض عبارات طلب بحث مميّزة بالخط الغامق. ويتم تضمين فواصل الأسطر في المقتطف لضمان التفاف النص بشكل مناسب. |
مثال | <S>واشنطن (CNN) - محاولة لإنهاء الخلافات القائمة في مجلس الشيوخ مع الرئيس 's</b> من خلال اختيارات قضائية تتيح لخمسة مرشحين إجراء تصويت نهائي مع الحفاظ على ... |
علامة فرعية لـ | 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 والذي يمكنك استخدامه كعبارة طلب بحث. | ||||||
السمات |
|
||||||
مثال | <Suggestion q="soccer"><b><i>soccer</i></b></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><i>Tip: في معظم المتصفحات، يؤدي الضغط على مفتاح Return إلى عرض النتائج نفسها التي يؤدي إليها النقر على الزر "بحث".</i></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> تفاصيل نتيجة بحث صور فردية. |
|||||||||
السمات |
| |||||||||
علامة فرعية لـ | المعدلات |
روسيا | |
---|---|
التعريف | تتضمن العلامة <RU tag> تفاصيل كل نتيجة من نتائج بحث الصور. |
علامة فرعية لـ | R |