XML API संदर्भ

यह पेज, Custom Search JSON API (एपीआई) के एक्सएमएल वर्शन के बारे में बताता है, जो सिर्फ़ Google साइट खोज ग्राहक.

1. खास जानकारी
2. Programmable Search Engine के अनुरोध का फ़ॉर्मैट
   1. अनुरोध की खास जानकारी
   2. क्वेरी की शर्तें
   3. अनुरोध के पैरामीटर
      1. WebSearch क्वेरी के सैंपल
      2. WebSearch क्वेरी पैरामीटर की परिभाषाएं
      3. ऐडवांस खोज
      4. बेहतर खोज क्वेरी पैरामीटर
      5. क्वेरी में इस्तेमाल होने वाले खास शब्द
      6. इमेज क्वेरी के सैंपल
      7. इमेज सर्च क्वेरी पैरामीटर
      8. अनुरोध करने की सीमाएं
   4. क्वेरी और नतीजों को अंतरराष्ट्रीय स्तर पर दिखाना
      1. कैरेक्टर एन्कोडिंग
      2. इंटरफ़ेस की भाषाएं
      3. सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ सर्च
   5. नतीजे फ़िल्टर करना
      1. खोज के नतीजों को अपने-आप फ़िल्टर करना
      2. भाषा और देश के हिसाब से फ़िल्टर करना
      3. सेफ़ सर्च की मदद से, वयस्कों के लिए बने कॉन्टेंट को फ़िल्टर करना
3. एक्सएमएल के नतीजे
   1. Google एक्सएमएल के नतीजे DTD
   2. एक्सएमएल रिस्पॉन्स के बारे में जानकारी
   3. रेगुलर, इमेज और ऐडवांस खोज क्वेरी
      1. सामान्य/ऐडवांस खोज: सैंपल क्वेरी और एक्सएमएल नतीजे
      2. सामान्य/ऐडवांस खोज: एक्सएमएल टैग
      3. इमेज सर्च क्वेरी के लिए एक्सएमएल के नतीजे
      4. इमेज खोज: सैंपल क्वेरी और एक्सएमएल नतीजा
      5. इमेज खोज: एक्सएमएल टैग

खास जानकारी

Google WebSearch सेवा की मदद से, Google Site Search को चालू किया जा सकता है ग्राहकों को अपनी वेब साइटों पर Google खोज परिणाम दिखाने के लिए करते हैं. कॉन्टेंट बनाने खोज सेवा दिखाने के लिए WebSearch सेवा, एक सामान्य एचटीटीपी-आधारित प्रोटोकॉल का इस्तेमाल करती है नतीजे. सर्च एडमिन के पास यह कंट्रोल होता है कि वे खोज परिणामों का अनुरोध करते हैं और यह अनुरोध करते हैं कि वे असली उपयोगकर्ता. इस दस्तावेज़ में Google के तकनीकी पहलुओं की जानकारी दी गई है खोज अनुरोध और परिणामों के प्रारूप में होता है.

Google WebSearch के नतीजे वापस पाने के लिए, आपका ऐप्लिकेशन Google एक सामान्य एचटीटीपी अनुरोध. इसके बाद Google, एक्सएमएल में खोज के नतीजे दिखाता है फ़ॉर्मैट. एक्सएमएल फ़ॉर्मैट वाले नतीजों से अपनी पसंद के मुताबिक खोज के नतीजे कैसे दिखाए जाते हैं.

WebSearch अनुरोध का फ़ॉर्मैट

• अनुरोध करें खास जानकारी
• क्वेरी की शर्तें
• अनुरोध के पैरामीटर
• WebSearch क्वेरी के सैंपल
• WebSearch क्वेरी पैरामीटर की परिभाषाएं
• इमेज क्वेरी के सैंपल
• इमेज सर्च क्वेरी पैरामीटर की परिभाषाएं
• बेहतर खोज
  
• ऐडवांस खोज क्वेरी पैरामीटर
• क्वेरी में इस्तेमाल होने वाले खास शब्द
• अनुरोध करने की सीमाएं

अनुरोध अवलोकन

Google Search का अनुरोध, एक स्टैंडर्ड एचटीटीपी GET कमांड है. यह में पैरामीटर का कलेक्शन शामिल होता है जो आपके क्वेरी. ये पैरामीटर, अनुरोध यूआरएल में name=value के तौर पर शामिल होते हैं एंपरसैंड (&) वर्णों से अलग किए गए जोड़े. पैरामीटर में ये शामिल हैं डेटा, जैसे कि खोज क्वेरी और यूनीक इंजन आईडी (cx), जो आपकी इंजन जो एचटीटीपी अनुरोध कर रहा है. WebSearch या Image Search सेवा वापस मिलती है एक्सएमएल के आपके अनुरोधों के जवाब में एक्सएमएल भेजा जाता है.

खोज में इस्तेमाल होने वाले शब्द और नाम

ज़्यादातर खोज अनुरोधों में एक या ज़्यादा क्वेरी शब्द शामिल होते हैं. क्वेरी के लिए इस्तेमाल किया गया शब्द खोज अनुरोध में एक पैरामीटर के मान के रूप में दिखाई देता है.

क्वेरी में इस्तेमाल हुए शब्द, फ़िल्टर करने के लिए कई तरह की जानकारी दे सकते हैं और उन खोज परिणामों को व्यवस्थित करें जिन्हें Google दिखाता है. क्वेरी में यह जानकारी हो सकती है:

• ऐसे शब्द या वाक्यांश जिन्हें शामिल करना है या छोड़ें
  • खोज क्वेरी में सभी शब्द (डिफ़ॉल्ट)
  • खोज क्वेरी का एक सटीक वाक्यांश
  • खोज क्वेरी में कोई शब्द या वाक्यांश
• दस्तावेज़ में कहां 'एक्सप्लोर करें' मॉड्यूल में, खोज के लिए शब्द
  • दस्तावेज़ में कहीं भी (डिफ़ॉल्ट)
  • सिर्फ़ दस्तावेज़ के मुख्य हिस्से में
  • सिर्फ़ दस्तावेज़ के टाइटल में
  • सिर्फ़ दस्तावेज़ के यूआरएल में
  • सिर्फ़ दस्तावेज़ में मौजूद लिंक में
• दस्तावेज़ों पर लागू पाबंदियां
  • किसी खास तरह के फ़ाइल टाइप के दस्तावेज़ शामिल करना या शामिल न करना (जैसे कि PDF फ़ाइलें या Word दस्तावेज़)
• यूआरएल की खास क्वेरी जो वापस दिखती हैं खोज करने के बजाय, दिए गए यूआरएल के बारे में जानकारी देखना
  • ऐसी क्वेरी जिनमें किसी यूआरएल के बारे में सामान्य जानकारी दी जाती है, जैसे कि इसकी ओपन डायरेक्ट्री कैटगरी, स्निपेट या भाषा
  • ऐसी क्वेरी जो यूआरएल से लिंक करने वाले वेब पेजों के सेट को दिखाती हैं
  • ऐसी क्वेरी जो दिए गए यूआरएल से मिलते-जुलते वेब पेजों का सेट दिखाती हैं

डिफ़ॉल्ट खोज

खोज क्वेरी पैरामीटर की वैल्यू, यूआरएल एस्केप होनी चाहिए. ध्यान दें कि किसी भी खाली सफ़ेद जगह के क्रम में, प्लस का निशान ("+") जोड़ देगा खोज क्वेरी. इसके बारे में ज़्यादा जानकारी, इस दस्तावेज़ के यूआरएल एस्केप करना सेक्शन में दी गई है.

खोज क्वेरी पद का उपयोग करके WebSearch सेवा को सबमिट किया जाता है q पैरामीटर. ऐप्लिकेशन सैंपल खोज क्वेरी शब्द है:

q=horses+cows+pigs

डिफ़ॉल्ट रूप से, Google WebSearch सेवा सिर्फ़ वही दस्तावेज़ वापस भेजती है जो सभी शब्दों को खोज क्वेरी में शामिल करना चाहिए.

अनुरोध के पैरामीटर

इस सेक्शन में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल करके, खोज अनुरोध. पैरामीटर दो सूचियों में बंटे होते हैं. पहली सूची में ऐसे पैरामीटर होते हैं जो सभी खोज अनुरोधों के लिए काम के होते हैं. दूसरी सूची में ऐसे पैरामीटर हैं जो हैं यह सिर्फ़ ऐडवांस खोज के अनुरोधों के लिए सही है.

तीन अनुरोध पैरामीटर ज़रूरी हैं:

• client पैरामीटर को google-csbe पर सेट किया जाना चाहिए
• आउटपुट पैरामीटर दिखाए गए एक्सएमएल नतीजों का फ़ॉर्मैट; (xml) के साथ नतीजे दिखाए जा सकते हैं या इसके बिना (xml_no_dtd) Google के DTD का कोई रेफ़रंस नहीं होना चाहिए. हमारा सुझाव है कि आप: इस वैल्यू को xml_no_dtd पर सेट कर रहा है. ध्यान दें: अगर इस पैरामीटर की जानकारी नहीं दी जाती है, तो नतीजे एक्सएमएल के बजाय, एचटीएमएल में होना चाहिए.
  
• cx पैरामीटर, जो यूनीक वैल्यू को दिखाता है इंजन का आईडी.
  

दूसरे पैरामीटर के अलावा, सबसे ज़्यादा इस्तेमाल किए जाने वाले अनुरोध पैरामीटर जिनका ज़िक्र ऊपर किया गया है:

• num—खोज नतीजों की अनुरोध की गई संख्या
• q—खोज के लिए इस्तेमाल हुए शब्द
• start—नतीजों के लिए शुरुआती इंडेक्स

WebSearch क्वेरी के सैंपल

नीचे दिए गए उदाहरण इससे पता चलता है कि अलग-अलग क्वेरी पैरामीटर का इस्तेमाल कैसे किया जाता है. परिभाषा WebSearch क्वेरी में अलग-अलग क्वेरी पैरामीटर उपलब्ध कराए जाते हैं पैरामीटर की परिभाषाएं और बेहतर खोज क्वेरी इस दस्तावेज़ के पैरामीटर सेक्शन.

इस अनुरोध में पहले 10 नतीजे दिखाने हैं (start=0&num=10) क्वेरी शब्द "रेड सॉक्स" के लिए (q=red+sox). क्वेरी भी यह बताता है कि नतीजे कनाडा की वेब साइटों (cr=countryCA) से आने चाहिए और यह फ़्रेंच (lr=lang_fr) में होना चाहिए. आखिर में, क्वेरी क्लाइंट, आउटपुट के लिए वैल्यू तय करता है, और 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 का इस्तेमाल करता है q पैरामीटर के बजाय पैरामीटर (as_q=red+sox) है. यह टूल, 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 क्वेरी पैरामीटर की परिभाषाएं

    <!DOCTYPE GSP SYSTEM "google.dtd">

बेहतर खोज

इमेज के नीचे दिए गए अन्य क्वेरी पैरामीटर, बेहतर खोज क्वेरी के लिए काम के होते हैं. बेहतर खोज सबमिट करने पर, कई पैरामीटर की वैल्यू (उदाहरण के लिए, as_eq, as_epq, as_oq वगैरह) को क्वेरी में शामिल किया जाता है उस खोज के लिए शब्द. इस इमेज में, Google का ऐडवांस खोज वाला पेज दिखाया गया है. इमेज पर, हर एक का नाम बेहतर खोज पैरामीटर, उसके अंदर या उसके बगल में लाल टेक्स्ट में लिखा होता है उस पेज पर फ़ील्ड, जिससे वह पैरामीटर संबंधित है.

बेहतर खोज क्वेरी पैरामीटर

क्वेरी में इस्तेमाल किए जाने वाले खास शब्द

Google Web Search, क्वेरी के लिए ऐसे कई खास शब्दों का इस्तेमाल करने की अनुमति देता है जो Google खोज इंजन की अतिरिक्त क्षमताओं का एक्सेस करता है. ये q अनुरोध पैरामीटर की वैल्यू में, खास क्वेरी के लिए शब्द शामिल होने चाहिए. अन्य क्वेरी शब्दों की तरह, क्वेरी के लिए खास शब्द यूआरएल-एस्केप होने चाहिए. ऐप्लिकेशन की संख्या में विशेष क्वेरी शब्दों में एक कोलन (:) होता है. यह किरदार यह भी ज़रूरी है कि यूआरएल एस्केप होने चाहिए; इसकी यूआरएल-एस्केप्ड वैल्यू %3A है.

इमेज क्वेरी के सैंपल

नीचे दिए गए उदाहरणों में, इमेज एचटीटीपी के कुछ अनुरोध दिखाए गए हैं. इनकी मदद से, अलग-अलग क्वेरी पैरामीटर का इस्तेमाल करने का तरीका बताया गया है. अलग-अलग क्वेरी पैरामीटर की परिभाषाएं, इस दस्तावेज़ के 'इमेज क्वेरी पैरामीटर की परिभाषाएं' सेक्शन में दी गई हैं.

यह अनुरोध, क्वेरी शब्द "बंदर" के लिए पहले पांच नतीजों (start=0&num=5) के लिए कहता है फ़ाइल टाइप .png में से (q=monkey). आखिर में, क्वेरी में client, output, और cx पैरामीटर की वैल्यू का पता चलता है. ये तीनों ज़रूरी हैं.

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

इमेज सर्च क्वेरी पैरामीटर

अनुरोध की सीमाएं

नीचे दिए गए चार्ट में उन खोज अनुरोधों की सीमाओं की जानकारी दी गई है जिन्हें आपने खोज के लिए इस्तेमाल किया है Google को भेजें:

क्वेरी और नतीजों को दुनिया भर में दिखाना

Google WebSearch सेवा की मदद से, कई भाषाओं में उपलब्ध है. आप कैरेक्टर एन्कोडिंग तय कर सकते हैं इसका इस्तेमाल आपके एचटीटीपी अनुरोध को समझने और एक्सएमएल रिस्पॉन्स को कोड में बदलने के लिए किया जाएगा (ieऔर oe खोज का इस्तेमाल करके पैरामीटर). नतीजों को सिर्फ़ दस्तावेज़ों को शामिल करने के लिए भी फ़िल्टर किया जा सकता है कुछ भाषाओं में लिखे गए हों.

इन सेक्शन में, Google पर खोज करने से जुड़ी समस्याओं के बारे में बताया गया है एकाधिक भाषाएं:

• वर्ण कोड में बदलने का तरीका
• इंटरफ़ेस की भाषाएं
• सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ खोजें

वर्ण एन्कोडिंग

सर्वर, वेब पेजों जैसा डेटा उपयोगकर्ता एजेंट को भेजते हैं, जैसे कि एन्कोड किए गए बाइट के क्रम के रूप में. इसके बाद, उपयोगकर्ता एजेंट डिकोड करता है बाइट को वर्णों के क्रम में लगाना होगा. को अनुरोध भेजते समय वेबखोज सेवा, आप दोनों के लिए एन्कोडिंग स्कीम निर्दिष्ट कर सकते हैं और आपको मिलने वाले एक्सएमएल रिस्पॉन्स के लिए भी इस्तेमाल किया जा सकता है.

यह तय करने के लिए कि ie अनुरोध पैरामीटर का इस्तेमाल किया जा सकता है आपके एचटीटीपी अनुरोध में मौजूद वर्णों को कोड में बदलने का तरीका. आप कोड में बदलने के तरीके की जानकारी देने के लिए भी oe पैरामीटर का इस्तेमाल करें एक्सएमएल के रिस्पॉन्स को कोड में बदलने के लिए, Google को इस स्कीम का इस्तेमाल करना चाहिए. अगर आप ISO-8859-1 (या latin1) के अलावा किसी अन्य एन्कोडिंग स्कीम का इस्तेमाल करके, कृपया पक्का करें कि आप सही मान दर्ज करें. ie और oe पैरामीटर के लिए.

ध्यान दें: अगर एक से ज़्यादा यूआरएल के लिए खोज करने की सुविधा दी जा रही है , हमारा सुझाव है कि आप utf8 (UTF-8) एन्कोडिंग वैल्यू का इस्तेमाल करें ie और oe पैरामीटर, दोनों के लिए लागू होता है.

कृपया वर्ण सीमा को देखें एन्कोडिंग स्कीम, जिसमें वैल्यू की पूरी सूची के लिए अपेंडिक्स शामिल है इसका इस्तेमाल ie और oe पैरामीटर के लिए किया जा सकता है.

कैरेक्टर एन्कोडिंग के बारे में ज़्यादा जानने के लिए, कृपया http://www.w3.org/TR/REC-html40/charset.html देखें.

इंटरफ़ेस की भाषाएं

hl अनुरोध पैरामीटर का इस्तेमाल करके, अपने ग्राफ़िकल इंटरफ़ेस की भाषा को पहचानें. hl पैरामीटर वैल्यू, एक्सएमएल के खोज नतीजों पर असर डाल सकती है. ऐसा खास तौर पर अंतरराष्ट्रीय क्वेरी, जब भाषा की पाबंदी (lr पैरामीटर का इस्तेमाल करके) साफ़ तौर पर न बताई गई हो. ऐसे में मामलों में, hl पैरामीटर खोज नतीजों को प्रमोट कर सकता है उसी भाषा में हो जो उपयोगकर्ता की इनपुट भाषा में है.

हमारा सुझाव है कि आप hl पैरामीटर को साफ़ तौर पर सेट करें ताकि यह पक्का किया जा सके कि Google हर क्वेरी के लिए खोज परिणाम.

कृपया काम करने वाला इंटरफ़ेस देखें भाषाएं सेक्शन में, hl पैरामीटर की मान्य वैल्यू की पूरी सूची देखी जा सकती है.

विशिष्ट भाषाओं में लिखे गए दस्तावेज़ों को खोजना

lr अनुरोध पैरामीटर का इस्तेमाल करके खोज परिणामों को उन दस्तावेज़ों तक सीमित करें जिन्हें किसी विशेष दस्तावेज़ में लिखा गया है भाषा या भाषाओं का सेट.

lr पैरामीटर बूलियन ऑपरेटर के साथ काम करता है, ताकि आपको यह जानकारी मिल सके एक से ज़्यादा ऐसी भाषाएं जिन्हें खोज में शामिल किया जाना चाहिए या शामिल नहीं किया जाना चाहिए नतीजे.

यहां दिए गए उदाहरणों में बताया गया है कि दस्तावेज़ों का अनुरोध करने के लिए, बूलियन ऑपरेटर का इस्तेमाल कैसे किया जा सकता है अलग-अलग भाषाओं में ब्राउज़ कर सकते हैं.

जैपनीज़ में लिखे गए दस्तावेज़ों के लिए:

lr=lang_jp

इटैलियन या जर्मन में लिखे दस्तावेज़ों के लिए:

lr=lang_it|lang_de

ऐसे दस्तावेज़ों के लिए जो हंगेरियन या चेक में नहीं लिखे गए हैं:

lr=(-lang_hu).(-lang_cs)

कृपया भाषा संग्रह देखें lr पैरामीटर और बूलियन' पैरामीटर की संभावित वैल्यू की पूरी सूची के लिए, वैल्यू सेक्शन ऑपरेटर सेक्शन में, इनके इस्तेमाल के बारे में पूरी जानकारी पाएं ऑपरेटर का इस्तेमाल करें.

सरल और पारंपरिक चीनी खोज

सिंप्लिफ़ाइड चाइनीज़ और ट्रेडिशनल चाइनीज़, लिखने के दो अलग-अलग वैरिएंट हैं के बारे में बात करते हैं. एक ही सिद्धांत को अलग तरह से लिखा जा सकता है हर वैरिएंट के लिए उपलब्ध हो. किसी एक वैरिएंट में क्वेरी की वजह से, Google WebSearch सेवा, ऐसे नतीजे दिखा सकती है जिनमें दोनों पेज शामिल हों अलग-अलग वर्शन का इस्तेमाल करें.

इस सुविधा का उपयोग करने के लिए:

1. c2coff अनुरोध पैरामीटर को 0 पर सेट करें
   और
2. इनमें से कोई एक काम करें:
   • lr अनुरोध पैरामीटर
     सेट न करें या
   • lr अनुरोध पैरामीटर को lr=lang_zh-TW|lang_zh-CN पर सेट करें

इस उदाहरण में ऐसे क्वेरी पैरामीटर दिखाए गए हैं जिन्हें नतीजों के अनुरोध में शामिल किया जाएगा सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़, दोनों में. (ध्यान दें कि अन्य ज़रूरी जानकारी, जैसे कि का इस्तेमाल क्लाइंट के तौर पर नहीं किया है, इसलिए इस उदाहरण में शामिल नहीं किया गया है.)

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

परिणाम फ़िल्टर करना

Google WebSearch आपको खोज को फ़िल्टर करने के कई तरीके उपलब्ध कराता है नतीजे:

• स्वचालित खोज के नतीजों को फ़िल्टर करना
• भाषा और देश के हिसाब से फ़िल्टर करना
• वयस्कों के लिए बने कॉन्टेंट को, इसके हिसाब से फ़िल्टर करना SafeSearch

खोज के नतीजों को अपने-आप फ़िल्टर करना

खोज के सबसे अच्छे नतीजे दिखाने के लिए, Google जो खोज परिणामों को अपने आप फ़िल्टर करने के लिए दो तकनीकों का उपयोग करता है, इन्हें आम तौर पर अनचाहे कामों के लिए माना जाता है:

• डुप्लीकेट कॉन्टेंट—अगर एक से ज़्यादा दस्तावेज़ों में तो उस सेट का सबसे प्रासंगिक दस्तावेज़ ही आपके खोज परिणामों में शामिल किया गया.

• होस्ट क्राउडिंग—अगर आपको एक ही साइट के रूप में है, तो हो सकता है कि Google उस साइट के सभी परिणाम न दिखाए या
  में नीचे के नतीजे दिखाओ रैंकिंग पहले की तुलना में कम थी.

हमारा सुझाव है कि आप सामान्य खोज अनुरोधों के लिए ये फ़िल्टर चालू रखें क्योंकि फ़िल्टर ज़्यादातर खोज की क्वालिटी को काफ़ी बेहतर बनाते हैं नतीजे. हालांकि, अपने-आप काम करने वाले इन फ़िल्टर को बायपास करने के लिए, फ़िल्टर क्वेरी पैरामीटर को 0 पर सेट किया जा सकता है. खोज अनुरोध.

भाषा और देश फ़िल्टर करना

Google WebSearch सेवा, इसके मास्टर इंडेक्स से नतीजे दिखाती है सभी वेब दस्तावेज़ों में. मास्टर इंडेक्स में इसके उप-संग्रह शामिल हैं ऐसे दस्तावेज़ जिन्हें भाषा या अन्य खास एट्रिब्यूट के हिसाब से ग्रुप में बांटा जाता है और मूल देश का नाम है.

खोज के नतीजों को इसके सब-कलेक्शन तक सीमित करने के लिए, lr और cr अनुरोध पैरामीटर का इस्तेमाल किया जा सकता है ऐसे दस्तावेज़ जो खास भाषाओं में लिखे गए हैं या जिनके स्रोत किसी देश में लागू होता है.

Google Web Search, विश्लेषण करके किसी दस्तावेज़ की भाषा तय करता है:

• दस्तावेज़ के यूआरएल का टॉप लेवल डोमेन (टीएलडी)
• दस्तावेज़ में मौजूद भाषा वाले मेटा टैग
• दस्तावेज़ के मुख्य हिस्से में इस्तेमाल की गई मुख्य भाषा

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है कृपया lr पैरामीटर की परिभाषा भी देखें, जो खोज की जा रही है अलग-अलग भाषाओं में लिखे गए दस्तावेज़ों और भाषा कलेक्शन की वैल्यू को ज़्यादा जानकारी के लिए lr पैरामीटर के लिए वैल्यू के रूप में इस्तेमाल किया जाता है भाषा के आधार पर नतीजों को सीमित करने के बारे में जानकारी.

Google Web Search, विश्लेषण करके किसी दस्तावेज़ के देश का पता लगाता है:

• दस्तावेज़ के यूआरएल का टॉप लेवल डोमेन (टीएलडी)
• वेब सर्वर के आईपी पते का भौगोलिक स्थान

कृपया cr पैरामीटर और Country कलेक्शन की परिभाषा भी देखें वे वैल्यू जिनका इस्तेमाल cr पैरामीटर की वैल्यू के तौर पर किया जा सकता है. इससे देश के हिसाब से नतीजों पर पाबंदी लगाने के बारे में ज़्यादा जानकारी मिलेगी ऑरिजिन.

ध्यान दें: भाषा को एक साथ जोड़ा जा सकता है और देश के मान चुनें. इसके लिए उदाहरण के लिए, आप ऐसे दस्तावेज़ों का अनुरोध कर सकते हैं, जो फ़्रेंच में लिखे गए हैं और फ़्रांस या कनाडा से आए हैं या आप ऐसे दस्तावेज़ों का अनुरोध कर सकते हैं जो वे हॉलैंड के हैं और अंग्रेज़ी में नहीं लिखे गए हैं. lr और cr पैरामीटर, दोनों बूलियन ऑपरेटर के साथ काम करते हैं.

सेफ़ सर्च की मदद से, वयस्कों के लिए बना कॉन्टेंट फ़िल्टर करना

Google के कई ग्राहक, इनके लिए खोज के नतीजे नहीं दिखाना चाहते साइटें जिनमें वयस्कों के लिए कॉन्टेंट हो. सेफ़ सर्च फ़िल्टर का इस्तेमाल करके, यह पता लगाया जा सकता है कि जिनमें वयस्कों के लिए कॉन्टेंट होता है और उन्हें हटा दिया जाता है. Google के फ़िल्टर, कीवर्ड और वाक्यांशों की जांच करने के लिए मालिकाना हक वाली टेक्नोलॉजी का इस्तेमाल करते हैं जोड़ें. हालांकि कोई भी फ़िल्टर 100 प्रतिशत सटीक नहीं होता, लेकिन सेफ़ सर्च की सुविधा अपनी खोज से बहुत ज़्यादा वयस्क सामग्री हटाएं नतीजे.

Google, सेफ़ सर्च की सेटिंग को मौजूदा समय के अंदर बेहतर बनाने की कोशिश करता है. लगातार वेब को क्रॉल करके और अपडेट को शामिल करके उपयोगकर्ता के सुझावों से.

सेफ़ सर्च की सुविधा, इन भाषाओं में उपलब्ध है:

Google आपके खोज नतीजों को जिस हद तक फ़िल्टर करता है उसे अडजस्ट किया जा सकता है safe क्वेरी पैरामीटर का इस्तेमाल करके वयस्क सामग्री. नीचे दी गई टेबल में, Google की सेफ़ सर्च की सेटिंग के बारे में जानकारी दी गई है. साथ ही, यह भी बताया गया है कि वे सेटिंग से आपके खोज के नतीजों पर असर पड़ेगा:

अगर आपने सेफ़ सर्च की सेटिंग चालू की है और आपको खोज के नतीजों में, अगर आपको लगता है कि आपके नतीजों में आपत्तिजनक कॉन्टेंट दिख रहा है, तो कृपया साइट के यूआरएल को safesearch@google.com पर ईमेल करें. साइट की जांच करेगा.

एक्सएमएल नतीजे

• Google एक्सएमएल डीटीडी के नतीजे
• एक्सएमएल रिस्पॉन्स के बारे में जानकारी
• XML सामान्य और ऐडवांस खोज क्वेरी के लिए नतीजे
• नियमित/बेहतर खोज: सैंपल क्वेरी और एक्सएमएल के नतीजे
• सामान्य/ऐडवांस खोज: एक्सएमएल टैग

Google XML परिणाम DTD

Google सभी तरह के एक्सएमएल फ़ॉर्मैट के बारे में बताने के लिए, एक ही DTD का इस्तेमाल करता है खोज के नतीजे. कई टैग और एट्रिब्यूट सभी के लिए लागू होते हैं खोज प्रकार. हालांकि, कुछ टैग केवल खास लोगों के लिए ही लागू होते हैं खोज प्रकार. इस वजह से, डीटीडी की परिभाषाएं कम हो सकती हैं इस दस्तावेज़ में बताई गई परिभाषाओं से ज़्यादा पाबंदी वाला है.

इस दस्तावेज़ में डीटीडी के उन पहलुओं के बारे में बताया गया है जो काम के हैं WebSearch के लिए. अगर डीटीडी को देखा जाता है, तो आप उन टैग और एट्रिब्यूट को सुरक्षित रूप से अनदेखा कर सकते हैं जो दस्तावेज़ यहां दिए गए हैं. अगर परिभाषा DTD और दस्तावेज़ में बताया गया है, तो यह तथ्य इस दस्तावेज़ में दिया गया है.

Google, इनके रेफ़रंस के साथ या इनके बिना, एक्सएमएल नतीजे दे सकता है DTD. DTD, खोज एडमिन की मदद करने के लिए एक गाइड है और एक्सएमएल पार्सर, Google के एक्सएमएल नतीजों को समझते हैं. क्योंकि Google के एक्सएमएल व्याकरण समय-समय पर बदल सकता है, इसलिए आपको अपने पार्सर का इस्तेमाल करें.

इसके अलावा, आपको हर बार खोज का अनुरोध सबमिट करने पर DTD. Google, डीटीडी को अपडेट करता है ऐसा बहुत कम होता है. इन अनुरोधों की वजह से बेवजह की देरी और बैंडविड्थ होती है ज़रूरतें.

Google का सुझाव है कि एक्सएमएल नतीजे पाने के लिए, आप xml_no_dtd आउटपुट फ़ॉर्मैट का इस्तेमाल करें. अगर खोज अनुरोध में xml आउटपुट फ़ॉर्मैट चुना जाता है, तो अंतर सिर्फ़ यह है कि एक्सएमएल नतीजों में नीचे दी गई लाइन शामिल की जाती है:

<!DOCTYPE GSP SYSTEM "google.dtd">

नए डीटीडी को यहां ऐक्सेस किया जा सकता है: http://www.google.com/google.dtd.

कृपया ध्यान दें कि हो सकता है कि इस समय DTD की सभी सुविधाएं उपलब्ध न हों या समर्थित न हों.

एक्सएमएल रिस्पॉन्स के बारे में जानकारी

• सभी एलिमेंट वैल्यू मान्य एचटीएमएल के तौर पर तब तक नहीं हैं, जब तक इन्हें डिसप्ले नहीं किया जा सकता जो एक्सएमएल टैग की परिभाषाओं में दी गई है.
• कुछ एलिमेंट वैल्यू ऐसे यूआरएल होते हैं जिन्हें यूआरएल से पहले, एचटीएमएल-एन्कोडेड में डालना ज़रूरी होता है वे दिखाए जाते हैं.
• आपके एक्सएमएल पार्सर को ऐसे एट्रिब्यूट और टैग को अनदेखा करना चाहिए जो दस्तावेज़ में नहीं हैं. इससे आपके ऐप्लिकेशन को बिना किसी बदलाव के काम करना जारी रखने की अनुमति मिलती है अगर Google, इस एक्सएमएल आउटपुट में ज़्यादा सुविधाएं जोड़ता है.
• मान के रूप में शामिल करने पर कुछ वर्णों का एस्केप होना ज़रूरी है एक्सएमएल टैग. आपके एक्सएमएल प्रोसेसर को ये इकाइयां सही वर्णों का इस्तेमाल करें. यदि आप इकाइयों को सही ढंग से रूपांतरित नहीं करते हैं, उदाहरण के लिए, ब्राउज़र & "& के रूप में वर्ण. एक्सएमएल स्टैंडर्ड दस्तावेज़ों में ये वर्ण शामिल होते हैं; ये वर्ण हैं नीचे दी गई टेबल में दिया गया है:

  वर्ण	एस्केप्ड फ़ॉर्म्स	इकाई	वर्ण कोड
  एंपरसैंड	&	&	&
  सिंगल कोट	'	'	'
  डबल कोट	"	"	"
  इससे ज़्यादा	>	>	>
  इससे कम	<	&lt;	&#60;

सामान्य और बेहतर खोज क्वेरी के लिए एक्सएमएल नतीजे

सामान्य/बेहतर खोज: सैंपल क्वेरी और एक्सएमएल नतीजे

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 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>

नियमित/बेहतर खोज: एक्सएमएल टैग

नियमित खोज के अनुरोधों और बेहतर खोज के लिए एक्सएमएल रिस्पॉन्स दोनों अनुरोध, एक्सएमएल टैग के एक जैसे सेट का इस्तेमाल करते हैं. ये एक्सएमएल टैग यहां दिखाए गए हैं जैसा कि ऊपर बताया गया है. साथ ही, इसकी जानकारी नीचे टेबल में दी गई है.

यहां दिए गए एक्सएमएल टैग को अंग्रेज़ी वर्णमाला के क्रम में टैग के नाम के हिसाब से सूची में रखा गया है और हर टैग की परिभाषा में टैग का ब्यौरा होता है. उदाहरण के लिए, एक्सएमएल नतीजे में टैग किस तरह से दिखेगा और टैग का फ़ॉर्मैट कॉन्टेंट. अगर टैग किसी दूसरे एक्सएमएल टैग का सब-टैग है या टैग में अपने खुद के सब-टैग या एट्रिब्यूट हैं, तो वह जानकारी इसमें भी दी गई है टैग की परिभाषा टेबल.

कुछ सब-टैग के आगे कुछ सिंबल दिखाए जा सकते हैं नीचे दी गई परिभाषाएं देखें. ये निशान और उनके मतलब इस तरह से हैं:

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

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

इमेज सर्च क्वेरी के लिए एक्सएमएल के नतीजे

इमेज के इस सैंपल में, खोज के लिए इस्तेमाल हुए शब्द "बंदर" के बारे में पांच नतीजे (num=5) मांगे गए हैं (q=बंदर).

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

इस अनुरोध से नीचे दिया गया एक्सएमएल नतीजा मिलता है.

G<SP VER="3.2"
>  T<M0>.395037/<TM
>  Q<m>onkeys/<Q
>
  P<ARAM name="cx" value="011737558837375720776:mbfrjmyam1g" original_value="011737558837375720776:mbfrjmyam1g" url_e<scaped_value="011737558837375720776%3Ambfrjmyam1g" js_escaped_value="011737558837375720776:mbfrjmyam1g"/
>  P<ARAM name="client" value="google-csbe" original_value="google-csbe" url_escaped_value="google-csbe" js_escaped_value="google-csbe"/
>  P<ARAM name="q" value="monkeys" original_value="monkeys" url_escaped_value="monkeys" js_escaped_value="monkeys"/
>  P<ARAM name="num" value="2" original_value="2" url_escaped_value="2" js_escaped_value="2"/
>  P<ARAM name="output" value="xml_no_dtd" original_value="xml_no_dtd" url_escaped_value="xml_no_dtd" js_escaped_value="xml_no_dtd"/
>  P<ARAM name="adkw" value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" original_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" url_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A" js_escaped_value="AELymgUP4VYSok20wy9SeYczEZ5UXxpBmRsJH4oC4aXhVuZgwGKuponcNXjrYkkw2bRv1BylIm89ndJ-Q4vxvyW0tcbiqipcQC9op_cBG84T12WMvX8660A"/
>  P<ARAM name="hl" value="en" original_value="en" url_escaped_value="en" js_escaped_value="en"/
>  P<ARAM name="oe" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="ie" value="UTF-8" original_value="UTF-8" url_escaped_value="UTF-8" js_escaped_value="UTF-8"/
>  P<ARAM name="boostcse" value="0" original_value="0" url_escaped_value="0" js_escaped_value="0"/
>
  C<ontext
>    t<itled>omestigeek/<title
>  /<Context
>
  A<RES/
>  R<ES SN="1" EN="2"
>    M<2>500000/<M
>    N<B
>      N<U/>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
>    R<G START="1" SIZE="2"/
>      R< N="1" MIME="image/jpeg"
>        R<Uh>ttp://www.flickr.com/photos/fncll/135465558//<RU
>        U<
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/46/135465558_123402af8c.jpg
        /<UE
>        T<C>omputer b<M>onkeys/<b >| Flickr - Photo Sharing!/<T
>        R<K0>/<RK
>        B<YLINEDATE1>146034800/<BYLINEDATE
>        S<C>omputer b<M>onkeys/<b >| Flickr/<S
>        L<ANGe>n/<LANG
>        I<MG WH="500" HT="305" IID="ANd9GcQARKLwzi-t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"
>          S<Z8>8386/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="130" HT="79" URL="http://t0.gstatic.com/images?q=tbn:ANd9GcQARKLwzi-
t4lpWi2AERV3kJb4ansaQzTn3MNDZR9fD_JDiktPKByKUBLs"/
>      /<R
>      R< N="2" MIME="image/jpeg"
>        R<U
>          http://www.flickr.com/photos/flickerbulb/187044366/
        /<RU
>        U<
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<U
>        U<E
>          http://farm1.static.flickr.com/73/187044366_506a1933f4.jpg
        /<UE
>        T<
>          one. ugly. b<m>onkey/<b.> | Flickr - Photo Sharing!
        /<T
>        R<K0>/<RK
>        B<YLINEDATE1>152514800/<BYLINEDATE
>        S<o>ne. ugly. b<m>onkey/<b.>/<S
>        L<ANGe>n/<LANG
>        I<MG WH="400" HT="481" IID="ANd9GcQ3Qom0bYbee4fThCQVi96jMEwMU6IvVf2b8K5vERKVw-
           EF4tQQnDDKOq0"S><Z5>8339/<SZ
>          I<N/
>        /<IMG
>        T<BN TYPE="0" WH="107" HT="129" URL="http://t1.gstatic.com/images?q=tbn:ANd9GcQ3Qom0bYbee4fThCQ
          Vi96jMEwMU6IvVf2b8K5vERKVw-EF4tQQnDDKOq0"/
>      /<R
>  /<RES
>/<GSP
>

इमेज सर्च: एक्सएमएल टैग

नीचे दी गई टेबल में अतिरिक्त एक्सएमएल टैग दिए गए हैं, जिनका इस्तेमाल इमेज सर्च क्वेरी के लिए एक्सएमएल जवाबों में किया जाता है.

कुछ सब-टैग के आगे कुछ सिंबल दिखाए जा सकते हैं नीचे दी गई परिभाषाएं देखें. ये निशान और उनके मतलब इस तरह से हैं: