XML API संदर्भ

इस पेज पर, Custom Search JSON API के XML वर्शन के बारे में बताया गया है. यह सिर्फ़ Google Site Search के ग्राहकों के लिए उपलब्ध है.

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 XML Results DTD
   2. एक्सएमएल रिस्पॉन्स के बारे में जानकारी
   3. सामान्य, इमेज, और बेहतर खोज क्वेरी के लिए एक्सएमएल नतीजे
      1. सामान्य/ऐडवांस खोज: क्वेरी और एक्सएमएल नतीजे का सैंपल
      2. सामान्य/ऐडवांस खोज: एक्सएमएल टैग
      3. इमेज खोजने के लिए की गई क्वेरी के लिए, XML फ़ॉर्मैट में नतीजे
      4. इमेज खोज: क्वेरी का सैंपल और एक्सएमएल नतीजा
      5. इमेज सर्च: एक्सएमएल टैग

खास जानकारी

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

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

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

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

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

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

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

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

क्वेरी टर्म में कई तरह की जानकारी दी जा सकती है. इससे Google को खोज के नतीजों को फ़िल्टर करने और व्यवस्थित करने में मदद मिलती है. क्वेरी में ये जानकारी दी जा सकती है:

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

डिफ़ॉल्ट सर्च

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

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

q=horses+cows+pigs

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

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

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

अनुरोध के लिए तीन पैरामीटर ज़रूरी हैं:

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

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

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

वेब पर खोज करने के लिए क्वेरी के उदाहरण

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

इस अनुरोध में, "रेड सॉक्स" (q=red+sox) क्वेरी के लिए पहले 10 नतीजे (start=0&num=10) मांगे गए हैं. क्वेरी में यह भी बताया गया है कि नतीजे, कनाडा की वेबसाइटों (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

इस उदाहरण में, सर्च क्वेरी को ज़्यादा बेहतर बनाने के लिए, ऐडवांस सर्च क्वेरी के कुछ पैरामीटर इस्तेमाल किए गए हैं. इस अनुरोध में, q पैरामीटर के बजाय as_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 WebSearch, कई खास क्वेरी शब्दों का इस्तेमाल करने की अनुमति देता है. इनसे Google सर्च इंजन की अतिरिक्त सुविधाओं को ऐक्सेस किया जा सकता है. इन खास क्वेरी शब्दों को q अनुरोध पैरामीटर की वैल्यू में शामिल किया जाना चाहिए. अन्य क्वेरी शब्दों की तरह, खास क्वेरी शब्दों को भी यूआरएल-एस्केप किया जाना चाहिए. कई खास क्वेरी शब्दों में कोलन (:) होता है. इस वर्ण को भी यूआरएल-एस्केप किया जाना चाहिए. इसकी यूआरएल-एस्केप की गई वैल्यू %3A है.

इमेज क्वेरी के उदाहरण

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

इस अनुरोध में, फ़ाइल टाइप .png के लिए, क्वेरी टर्म "monkey" (q=monkey) के पहले पांच नतीजे (start=0&num=5) मांगे गए हैं. आखिर में, क्वेरी में 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 सर्च पैरामीटर का इस्तेमाल करें. आपके पास खोज के नतीजों को फ़िल्टर करने की सुविधा भी होती है. जैसे, ऐसे फ़िल्टर जिसमें सिर्फ़ वे दस्तावेज़ दिखें जो चुनिंदा भाषाओं में लिखे गए हों.

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

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

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

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

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

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

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 पर, खोज के नतीजों को फ़िल्टर करने के कई तरीके उपलब्ध हैं:

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

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

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

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

• होस्ट क्राउडिंग—अगर एक ही साइट के कई खोज नतीजे हैं, तो हो सकता है कि Google उस साइट के सभी नतीजे न दिखाए. ऐसा भी हो सकता है कि वह नतीजों को रैंकिंग में नीचे दिखाए
  .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

एक्सएमएल फ़ॉर्मैट में नतीजे

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

Google XML Results DTD

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

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

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

इसके अलावा, आपको अपने XML पार्सर को इस तरह कॉन्फ़िगर नहीं करना चाहिए कि वह हर बार खोज का अनुरोध सबमिट करने पर, डीटीडी फ़ेच करे. Google, डीटीडी को कभी-कभी अपडेट करता है. साथ ही, इन अनुरोधों से बेवजह देरी होती है और बैंडविथ की ज़रूरत पड़ती है.

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

<!DOCTYPE GSP SYSTEM "google.dtd">

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

कृपया ध्यान दें कि इस समय, डीटीडी में मौजूद सभी सुविधाएं उपलब्ध नहीं हो सकती हैं या काम नहीं कर सकती हैं.

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

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

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

सामान्य और ऐडवांस खोज क्वेरी के लिए एक्सएमएल नतीजे

सामान्य/ऐडवांस खोज: क्वेरी और एक्सएमएल नतीजे का उदाहरण

इस WebSearch अनुरोध के सैंपल में, खोज शब्द "socer" (q=socer) के बारे में 10 नतीजे (num=10) दिखाने के लिए कहा गया है. इस उदाहरण के लिए, "soccer" शब्द को जान-बूझकर गलत लिखा गया है.

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>

सामान्य/ऐडवांस खोज: एक्सएमएल टैग

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

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

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

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

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

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

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

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

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

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

इमेज खोज: एक्सएमएल टैग

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

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