XML API संदर्भ

यह पेज, कस्टम खोज JSON एपीआई के एक्सएमएल वर्शन को दिखाता है, जो सिर्फ़ Google Site Search के ग्राहकों के लिए उपलब्ध है.

  1. खास जानकारी
  2. Programmable Search Engine के अनुरोध का फ़ॉर्मैट
    1. अनुरोध की खास जानकारी
    2. क्वेरी की शर्तें
    3. पैरामीटर का अनुरोध करें
      1. वेबखोज क्वेरी का नमूना
      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 के खोज नतीजे दिखा सकते हैं. Search के नतीजे दिखाने के लिए, WebSearch सेवा, एचटीटीपी पर आधारित एक आसान प्रोटोकॉल का इस्तेमाल करती है. सर्च एडमिन के पास इस बात का पूरा कंट्रोल होता है कि वे खोज के नतीजों के लिए किस तरह अनुरोध करें. साथ ही, उन नतीजों को असली उपयोगकर्ता को किस तरह से दिखाया जाए. इस दस्तावेज़ में, Google पर खोज के अनुरोध और नतीजों के फ़ॉर्मैट की तकनीकी जानकारी दी गई है.

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

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

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

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

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

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

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

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

डिफ़ॉल्ट खोज

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

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

q=horses+cows+pigs

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

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

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

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

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

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

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

WebSearch क्वेरी का नमूना

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

इस अनुरोध में, "red sox" (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) में से "Yankees" शब्द वाले किसी भी दस्तावेज़ को शामिल न करने के लिए, as_eq पैरामीटर का भी इस्तेमाल किया जाता है.

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 पैरामीटर की मदद से, सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ सर्च की सुविधा को चालू या बंद किया जा सकता है.

इस पैरामीटर की डिफ़ॉल्ट वैल्यू 0 (शून्य) है. इसका मतलब है कि सुविधा चालू है. c2coff पैरामीटर के लिए वैल्यू इस तरह हैं:

वैल्यू कार्रवाई
1 अक्षम किया गया
0 चालू
उदाहरण q=google&c2coff=1

क्लाइंट
जानकारी

ज़रूरी है. client पैरामीटर को google-csbe पर सेट करना ज़रूरी है.

उदाहरण q=google&client=google-csbe

cr
जानकारी

Optional. cr पैरामीटर, खोज के नतीजों में किसी खास देश से जुड़े दस्तावेज़ों को ही शामिल करता है. cr पैरामीटर की वैल्यू में, बूलियन ऑपरेटर का इस्तेमाल किया जा सकता है.

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

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

इस पैरामीटर के लिए मान्य वैल्यू की सूची देखने के लिए, देश (cr) पैरामीटर की वैल्यू सेक्शन देखें.

उदाहरण q=Frodo&cr=countryNZ

cx
जानकारी

ज़रूरी है. cx पैरामीटर एक यूनीक कोड तय करता है, जो कस्टम सर्च इंजन की पहचान करता है. आपको उस इंजन से खोज के नतीजे फिर से पाने के लिए, cx पैरामीटर का इस्तेमाल करके Programmable Search Engine तय करना होगा.

cx पैरामीटर की वैल्यू जानने के लिए, अपने इंजन के कंट्रोल पैनल > कोड टैब पर जाएं. इसके बाद, यह आपको टेक्स्ट एरिया में, 'इस कोड को पेज में उस जगह चिपकाएं जहां आपको खोज बॉक्स दिखाना है' में दिखेगा. खोज के नतीजे, Google के होस्ट किए गए पेज पर दिखाए जाएंगे.

उदाहरण q=Frodo&cx=00255077836266642015:u-scht7a-8i

फ़िल्‍टर
जानकारी

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

filter पैरामीटर की डिफ़ॉल्ट वैल्यू 1 है. इससे पता चलता है कि सुविधा चालू है. इस पैरामीटर के लिए मान्य वैल्यू ये हैं:

वैल्यू कार्रवाई
1 अक्षम किया गया
0 चालू

ध्यान दें: डिफ़ॉल्ट रूप से, Google खोज के सभी नतीजों पर फ़िल्टर लागू करके, खोज के उन नतीजों की क्वालिटी को बेहतर बनाता है.

उदाहरण q=google&filter=0

gl
जानकारी

Optional. gl पैरामीटर की वैल्यू, देश का दो अक्षरों वाला कोड होती है. WebSearch के नतीजों के लिए, gl पैरामीटर ऐसे खोज नतीजों की संख्या बढ़ाता है जिनके मूल देश का नाम, पैरामीटर की वैल्यू से मेल खाता है. मान्य वैल्यू की सूची देखने के लिए, देश के कोड सेक्शन देखें.

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

उदाहरण

यह अनुरोध, यूनाइटेड किंगडम में लिखे गए दस्तावेज़ों को WebSearch के नतीजों में शामिल करता है:
q=pizza&gl=uk


hl
जानकारी

Optional. hl पैरामीटर से, आपके यूज़र इंटरफ़ेस की इंटरफ़ेस भाषा (होस्ट की भाषा) के बारे में पता चलता है. हमारा सुझाव है कि खोज के नतीजों की परफ़ॉर्मेंस और क्वालिटी को बेहतर बनाने के लिए, आप इस पैरामीटर को साफ़ तौर पर सेट करें.

ज़्यादा जानकारी के लिए, अंतरराष्ट्रीय क्वेरी करने और नतीजों का प्रज़ेंटेशन का इंटरफ़ेस भाषाएं सेक्शन देखें. साथ ही, इस्तेमाल की जा सकने वाली भाषाओं की सूची देखने के लिए, इंटरफ़ेस पर काम करने वाली भाषाएं देखें.

उदाहरण

यह अनुरोध फ़्रेंच भाषा की वाइन के विज्ञापनों को टारगेट करता है. (Vin, वाइन के लिए फ़्रेंच है.)

q=vin&ip=10.10.10.10&ad=w5&hl=fr

अच्छी क्वालिटी
जानकारी

Optional. hq पैरामीटर, क्वेरी में तय किए गए शब्दों को इस तरह जोड़ता है जैसे उन्हें किसी लॉजिकल AND ऑपरेटर के साथ जोड़ा गया हो.

उदाहरण

यह अनुरोध 'पिज़्ज़ा' AND 'चीज़' के लिए खोजता है. एक्सप्रेशन q=pizza+cheese के समान है.

q=pizza&hq=cheese


ie
जानकारी

Optional. ie पैरामीटर, कैरेक्टर एन्कोडिंग स्कीम सेट करता है. इसका इस्तेमाल क्वेरी स्ट्रिंग को समझने के लिए किया जाना चाहिए. ie की डिफ़ॉल्ट वैल्यू latin1 है.

इस पैरामीटर का इस्तेमाल कब करना पड़ सकता है, इस बारे में जानने के लिए वर्ण एन्कोडिंग सेक्शन देखें.

संभावित ie वैल्यू की सूची के लिए, कैरेक्टर एन्कोडिंग स्कीम सेक्शन देखें.

उदाहरण q=google&ie=utf8&oe=utf8
lr
जानकारी

Optional. lr (भाषा से जुड़ी पाबंदी) पैरामीटर, खोज के नतीजों को किसी खास भाषा में लिखे गए दस्तावेज़ों तक सीमित करता है.

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

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

इस पैरामीटर के लिए मान्य वैल्यू की सूची के लिए, भाषा (lr) कलेक्शन की वैल्यू सेक्शन देखें.

उदाहरण q=Frodo&lr=lang_en

num
जानकारी

Optional. num पैरामीटर, खोज के नतीजों की संख्या की पहचान करता है.

num की डिफ़ॉल्ट वैल्यू 10 है और ज़्यादा से ज़्यादा वैल्यू 20 है. अगर आप 20 से ज़्यादा नतीजों के लिए अनुरोध करते हैं, तो सिर्फ़ 20 नतीजे दिखाए जाएंगे.

ध्यान दें: अगर खोज के नतीजों की कुल संख्या, मांगे गए नतीजों की संख्या से कम है, तो सभी उपलब्ध खोज नतीजे दिखाए जाएंगे.

उदाहरण q=google&num=10

oe
जानकारी

Optional. oe पैरामीटर, कैरेक्टर एन्कोडिंग स्कीम सेट करता है. इसका इस्तेमाल एक्सएमएल नतीजे को डिकोड करने के लिए किया जाना चाहिए. oe की डिफ़ॉल्ट वैल्यू latin1 है.

इस पैरामीटर का इस्तेमाल कब करना पड़ सकता है, इस बारे में जानने के लिए वर्ण एन्कोडिंग सेक्शन देखें.

संभावित oe वैल्यू की सूची के लिए, कैरेक्टर एन्कोडिंग स्कीम सेक्शन देखें.

उदाहरण q=google&ie=utf8&oe=utf8

आउटपुट
जानकारी

ज़रूरी है. output पैरामीटर, एक्सएमएल नतीजों का फ़ॉर्मैट बताता है. इस पैरामीटर के लिए, सिर्फ़ xml और xml_no_dtd मान्य वैल्यू दी जा सकती हैं. नीचे दिए गए चार्ट में बताया गया है कि इन पैरामीटर वैल्यू में क्या अंतर है.

वैल्यू आउटपुट फ़ॉर्मैट
xml_no_dtd एक्सएमएल के नतीजों में !DOCTYPE स्टेटमेंट शामिल नहीं होगा. (सुझाया गया)
xml एक्सएमएल के नतीजों में, Google DTD का रेफ़रंस शामिल होगा. नतीजे की दूसरी लाइन, दस्तावेज़ की परिभाषा के उस टाइप (डीटीडी) की पहचान करेगी जिसका इस्तेमाल नतीजे में करते हैं:
    <!DOCTYPE GSP SYSTEM "google.dtd">
उदाहरण output=xml_no_dtd
output=xml

q
जानकारी

Optional. q पैरामीटर से पता चलता है कि उपयोगकर्ता ने कौनसी खोज क्वेरी डाली है. यह पैरामीटर ज़रूरी नहीं है, लेकिन खोज के नतीजे पाने के लिए, आपको कम से कम किसी एक क्वेरी पैरामीटर (as_epq, as_lq, as_oq, as_q के लिए वैल्यू तय करनी होगी.

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

Google Search के कंट्रोल पैनल में, q पैरामीटर का इस्तेमाल करके सबमिट की गई मुख्य क्वेरी की रिपोर्ट शामिल होती है.

ध्यान दें: q पैरामीटर के लिए तय की गई वैल्यू, यूआरएल-एस्केप्ड होनी चाहिए.

उदाहरण q=vacation&as_oq=london+paris

सुरक्षित
जानकारी

Optional. safe पैरामीटर यह बताता है कि वयस्क और पोर्नोग्राफ़ी वाले कॉन्टेंट के लिए, खोज के नतीजों को कैसे फ़िल्टर किया जाना चाहिए. safe पैरामीटर के लिए डिफ़ॉल्ट वैल्यू off है. पैरामीटर की मान्य वैल्यू ये हैं:

वैल्यू कार्रवाई
off सेफ़ सर्च की सुविधा बंद करें
medium सेफ़ सर्च की सुविधा चालू करें
high सेफ़ सर्च की सुविधा का ज़्यादा सख्त वर्शन चालू करें

इस सुविधा के बारे में ज़्यादा जानने के लिए, सेफ़ सर्च की मदद से वयस्कों के लिए बने कॉन्टेंट को फ़िल्टर करना सेक्शन देखें.

उदाहरण q=adult&safe=high

शुरू करें
जानकारी

Optional. start पैरामीटर से पता चलता है कि खोज के नतीजों में पहले मेल खाने वाला नतीजा शामिल किया जाना चाहिए. start पैरामीटर, शून्य पर आधारित इंडेक्स का इस्तेमाल करता है. इसका मतलब है कि पहला नतीजा 0 है और दूसरा नतीजा 1 है और यह इसी तरह बाकी है.

start पैरामीटर, num पैरामीटर के साथ काम करके यह तय करता है कि खोज के कौनसे नतीजे दिखाने हैं. ध्यान दें कि किसी क्वेरी के लिए, 1,000 से ज़्यादा नतीजे कभी नहीं दिखाए जाएंगे. भले ही, उस क्वेरी से मेल खाने वाले 1,000 से ज़्यादा दस्तावेज़ हों. इसलिए, वैल्यू को 1,000 या उससे ज़्यादा पर सेट करने से कोई नतीजा नहीं मिलेगा.

उदाहरण start=10

क्रम से लगाएं
जानकारी

Optional. sort पैरामीटर से पता चलता है कि नतीजों को तय किए गए एक्सप्रेशन के मुताबिक क्रम से लगाया जाएगा. उदाहरण के लिए, तारीख के मुताबिक क्रम से लगाएं.

उदाहरण

sort=date


Ud
जानकारी

Optional. ud पैरामीटर से पता चलता है कि एक्सएमएल के रिस्पॉन्स में खोज के नतीजे के लिए, आईडीएन से कोड में बदला गया यूआरएल शामिल होना चाहिए या नहीं. आईडीएन (अंतरराष्ट्रीय डोमेन नाम) एन्कोडिंग की मदद से, डोमेन को स्थानीय भाषाओं में दिखाया जा सकता है. उदाहरण के लिए:

http://www.花井鮨.com

इस पैरामीटर के लिए सही वैल्यू 1 (डिफ़ॉल्ट) हैं. इसका मतलब है कि एक्सएमएल नतीजे में आईडीएन से कोड में बदले गए यूआरएल और 0 शामिल होने चाहिए. इसका मतलब है कि एक्सएमएल नतीजों में आईडीएन से कोड में बदले गए यूआरएल शामिल नहीं होने चाहिए. अगर ud पैरामीटर को 1 पर सेट किया गया है, तो आपके एक्सएमएल नतीजों के यूडी टैग में आईडीएन से कोड में बदला गया यूआरएल दिखेगा.

अगर ud पैरामीटर को 0 पर सेट किया गया है, तो ऊपर दिए गए उदाहरण में दिया गया यूआरएल इस तरह दिखेगा:

http://www.xn--elq438j.com.

ध्यान दें: यह बीटा वर्शन की सुविधा है.

उदाहरण q=google&ud=1

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



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

as_dt
जानकारी

Optional. as_dt पैरामीटर से यह कंट्रोल किया जाता है कि as_sitesearch पैरामीटर में नाम वाली साइट के नतीजों को शामिल करना है या बाहर रखना है. वैल्यू i और e वैल्यू, शामिल करने और बाहर रखने के बारे में बताती हैं.

उदाहरण as_dt=i,as_dt=e

as_epq
जानकारी

Optional. as_epq पैरामीटर ऐसे वाक्यांश की पहचान करता है जो खोज के नतीजों के सभी दस्तावेज़ों में मौजूद होना चाहिए. किसी वाक्यांश को खोजने के लिए, फ़्रेज़ सर्च क्वेरी के लिए शब्द का इस्तेमाल भी किया जा सकता है.

उदाहरण as_epq=abraham+lincoln

as_eq
जानकारी

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

उदाहरण

q=bass&as_eq=music.


as_lq
जानकारी

Optional. as_lq पैरामीटर से पता चलता है कि खोज के सभी नतीजों में किसी खास यूआरएल का लिंक शामिल होना चाहिए. इस तरह की क्वेरी के लिए, लिंक: क्वेरी शब्द का इस्तेमाल भी किया जा सकता है.

उदाहरण

as_lq=www.google.com


as_nlo
जानकारी

Optional. as_nlo पैरामीटर से यह पता चलता है कि किसी खोज रेंज के लिए शुरुआती वैल्यू कितनी है. क्वेरी में as_nlo...as_nhi की सभी शामिल वाली खोज रेंज जोड़ने के लिए, as_nlo और as_nhi का इस्तेमाल करें.

उदाहरण

नीचे 5 से 10 की खोज रेंज सेट की गई है, जिसमें ये भी शामिल हैं:

as_nlo=5&as_nhi=10

as_nhi
जानकारी

Optional. as_nhi पैरामीटर, किसी खोज रेंज की आखिरी वैल्यू बताता है. क्वेरी में as_nlo...as_nhi की खोज रेंज जोड़ने के लिए, as_nlo और as_nhi का इस्तेमाल करें.

उदाहरण

नीचे 5 से 10 की खोज रेंज सेट की गई है, जिसमें ये भी शामिल हैं:

as_nlo=5&as_nhi=10

as_oq
जानकारी

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

उदाहरण

q=vacation&as_oq=London+Paris


as_q
जानकारी

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

उदाहरण

q=president&as_q=John+Adams


as_qdr
जानकारी

Optional. as_qdr पैरामीटर, एक तय समयावधि (तारीख की कम सीमा) से खोज के नतीजों के लिए अनुरोध करता है. इन वैल्यू का इस्तेमाल किया जा सकता है:

d[number] अनुरोध, पिछले दिनों की तय संख्या के मुताबिक मिले.
w[number] अनुरोधों के नतीजे, पिछले हफ़्तों की तय संख्या के मुताबिक मिले.
m[number] अनुरोधों के नतीजे, पिछले महीनों की तय संख्या के मुताबिक मिले.
y[number] अनुरोध, पिछले सालों की तय संख्या के मुताबिक मिले हैं.

उदाहरण

इस उदाहरण में, पिछले साल के नतीजों का अनुरोध किया गया है:

as_qdr=y

इस उदाहरण में, पिछले 10 दिनों के नतीजों के लिए अनुरोध किया गया है:

as_qdr=d10

as_sitesearch
जानकारी

Optional. as_sitesearch पैरामीटर की मदद से, यह तय किया जा सकता है कि सभी खोज नतीजे, किसी साइट के पेज होने चाहिए. as_dt पैरामीटर सेट करके, इसका इस्तेमाल किसी साइट के पेजों को अपनी खोज नतीजों से बाहर रखने के लिए भी किया जा सकता है.

उदाहरण

q=vacation&as_sitesearch=www.google.com


विशेष क्वेरी शब्द

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

बैक लिंक [link:]
जानकारी

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

link: का यूआरएल-एस्केप्ड वर्शन link%3A है.

link: अनुरोध सबमिट करने के लिए, as_lq अनुरोध पैरामीटर का भी इस्तेमाल किया जा सकता है.

ध्यान दें: link: का इस्तेमाल करते समय, क्वेरी के लिए कोई और शब्द नहीं बताया जा सकता.

उदाहरण

http://www.google.com/search?q=link%3Awww.example.com


बूलियन या खोज [ OR ]
जानकारी

OR क्वेरी शब्द ऐसे दस्तावेज़ों को फिर से इकट्ठा करता है जिनमें एक (दो या ज़्यादा) क्वेरी शब्दों की सीरीज़ शामिल होती है. 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

क्वेरी शब्द [-] बाहर रखें
जानकारी

बाहर रखें (-) क्वेरी शब्द के इस्तेमाल से किसी खास खोज अनुरोध के नतीजे उन दस्तावेज़ों तक सीमित हो जाते हैं जिनमें कोई खास शब्द या वाक्यांश नहीं होता है. 'बाहर रखने वाली क्वेरी' शब्द का इस्तेमाल करने के लिए, आपको मिलते-जुलते दस्तावेज़ों से उस शब्द या वाक्यांश को बाहर रखने की शुरुआत करनी होगी जिसके लिए "-" (माइनस का निशान) लगा हो.

- का यूआरएल-एस्केप्ड वर्शन %2D है.

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

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

उदाहरण उपयोगकर्ता का इनपुट: bass -music
क्वेरी के लिए शब्द: q=bass+%2Dmusic

फ़ाइल टाइप एक्सक्लूज़न [ -filetype: ]
जानकारी

-filetype: क्वेरी शब्द में एक खास फ़ाइल एक्सटेंशन वाले दस्तावेज़ शामिल नहीं होते हैं, जैसे कि खोज नतीजों से ".pdf" या ".doc". खोज क्वेरी को -filetype:EXTENSION के तौर पर फ़ॉर्मैट किया जाना चाहिए. साथ ही, -filetype: क्वेरी शब्द और बताए गए एक्सटेंशन के बीच कोई स्पेस नहीं होना चाहिए.

-filetype: का यूआरएल-एस्केप्ड वर्शन %2Dfiletype%3A है.

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

Google जिन फ़ाइल टाइप का इस्तेमाल करता है उनमें ये शामिल हैं:

  • Adobe पोर्टेबल डॉक्यूमेंट फ़ॉर्मैट (pdf)
  • Adobe PostScript (पीएस)
  • लोटस 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • लोटस वर्डप्रो (lwp)
  • मैकराइट (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (पीपीटी)
  • Microsoft Word (दस्तावेज़)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • रिच टेक्स्ट फ़ॉर्मैट (rtf)
  • शॉकवेव फ़्लैश (swf)
  • टेक्स्ट (ans, txt).

आने वाले समय में, दूसरे फ़ाइल टाइप जोड़े जा सकते हैं. अप-टू-डेट सूची कभी भी Google के फ़ाइल टाइप के बारे में अक्सर पूछे जाने वाले सवाल में देखी जा सकती है.

उदाहरण

इस उदाहरण में ऐसे दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है, लेकिन वे PDF दस्तावेज़ नहीं हैं:
q=Google+%2Dfiletype%3Apdf

इस उदाहरण में वे दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है, लेकिन PDF और Word, दोनों तरह के दस्तावेज़ शामिल नहीं हैं:
q=Google+%2Dfiletype%3Apdf+%2Dfiletype%3Adoc


फ़ाइल प्रकार फ़िल्टर करना [ फ़ाइल प्रकार: ]
जानकारी

filetype: क्वेरी के लिए शब्द, खोज के नतीजों को ".pdf" या ".doc" जैसे किसी खास फ़ाइल एक्सटेंशन वाले दस्तावेज़ों तक सीमित करता है. खोज क्वेरी को filetype:EXTENSION के तौर पर फ़ॉर्मैट किया जाना चाहिए. इसमें filetype: क्वेरी शब्द और बताए गए एक्सटेंशन के बीच कोई स्पेस नहीं होना चाहिए.

filetype: का यूआरएल-एस्केप्ड वर्शन filetype%3A है.

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

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

Google जिन फ़ाइल टाइप का इस्तेमाल करता है उनमें ये शामिल हैं:

  • Adobe पोर्टेबल डॉक्यूमेंट फ़ॉर्मैट (pdf)
  • Adobe PostScript (पीएस)
  • लोटस 1-2-3 (wk1, wk2, wk3, wk4, wk5, wki, wks, wku)
  • लोटस वर्डप्रो (lwp)
  • मैकराइट (mw)
  • Microsoft Excel (xls)
  • Microsoft PowerPoint (पीपीटी)
  • Microsoft Word (दस्तावेज़)
  • Microsoft Works (wks, wps, wdb)
  • Microsoft Write (wri)
  • रिच टेक्स्ट फ़ॉर्मैट (rtf)
  • शॉकवेव फ़्लैश (swf)
  • टेक्स्ट (ans, txt).

आने वाले समय में, दूसरे फ़ाइल टाइप जोड़े जा सकते हैं. अप-टू-डेट सूची कभी भी Google के फ़ाइल टाइप के बारे में अक्सर पूछे जाने वाले सवाल में देखी जा सकती है.

उदाहरण

इस उदाहरण में ऐसे PDF दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है:
q=Google+filetype%3Apdf

इस उदाहरण में ऐसे PDF और Word दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है:
q=Google+filetype%3Apdf+OR+filetype%3Adoc


क्वेरी शब्द शामिल करें [+]
जानकारी

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

+ का यूआरएल-एस्केप्ड वर्शन (प्लस का निशान) %2B है.

आपको + का इस्तेमाल उस सामान्य शब्द से पहले करना चाहिए जिसे Google आम तौर पर खोज के नतीजों की पहचान करने से पहले खारिज कर देता है.

उदाहरण उपयोगकर्ता का इनपुट: Star Wars Episode +I
क्वेरी के लिए शब्द: q=Star+Wars+Episode+%2BI

केवल लिंक खोज, सभी शब्द [ Allinlinks: ]
जानकारी

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

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

allinlinks: का यूआरएल-एस्केप्ड वर्शन allinlinks%3A है.

उदाहरण उपयोगकर्ता का इनपुट:allinlinks: Google search
क्वेरी के लिए शब्द:q=allinlinks%3A+Google+search

वाक्यांश खोज
जानकारी

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

" का यूआरएल-एस्केप्ड वर्शन (कोटेशन मार्क) %22 है.

वाक्यांश की खोज खास तौर पर तब मददगार होती है, जब आप मशहूर कोटेशन या सही नामों को खोज रहे हों.

फ़्रेज़ खोज को सबमिट करने के लिए, as_epq अनुरोध पैरामीटर का भी इस्तेमाल किया जा सकता है.

उदाहरण उपयोगकर्ता का इनपुट:"Abraham Lincoln"
क्वेरी के लिए शब्द: q=%22Abraham+Lincoln%22

सिर्फ़ टेक्स्ट के लिए खोज, सभी शब्द [allintext:]
जानकारी

allintext: क्वेरी शब्द के लिए ज़रूरी है कि खोज के नतीजों में मौजूद हर दस्तावेज़ में वह सभी शब्द शामिल हों जो खोज क्वेरी के मुख्य हिस्से में मौजूद हैं. क्वेरी को allintext: के फ़ॉर्मैट में, उसके बाद आपकी खोज क्वेरी में इस्तेमाल किए जाने वाले शब्द होने चाहिए.

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

allintext: का यूआरएल-एस्केप्ड वर्शन allintext%3A है.

उदाहरण इस उदाहरण से पता चलता है कि "Google" और "search" शब्द, खोज के नतीजों में शामिल सभी दस्तावेज़ों के मुख्य हिस्से में दिखने चाहिए:
उपयोगकर्ता का इनपुट:allintext:Google search
क्वेरी शब्द:q=allintext%3AGoogle+search

टाइटल सर्च, एक शब्द [intitle:]
जानकारी

intitle: क्वेरी के शब्द का इस्तेमाल करके, खोज के नतीजों में सिर्फ़ उन दस्तावेज़ों को शामिल किया जाता है जिनके टाइटल में कोई एक खास शब्द शामिल हो. खोज क्वेरी को intitle:WORD के तौर पर फ़ॉर्मैट किया जाना चाहिए. इसमें intitle: क्वेरी शब्द और उसके बाद के शब्द के बीच खाली जगह नहीं होनी चाहिए.

ध्यान दें: दस्तावेज़ के टाइटल में एक से ज़्यादा शब्द शामिल किए जा सकते हैं. इसके लिए, आपको ऐसे हर शब्द के आगे intitle: क्वेरी डालना होगा. allintitle: क्वेरी के लिए इस्तेमाल किए गए शब्द का इस्तेमाल यह बताने के लिए भी किया जा सकता है कि खोज के नतीजों में मौजूद दस्तावेज़ों के टाइटल में, क्वेरी के सभी शब्द शामिल किए जाएं.

intitle: का यूआरएल-एस्केप्ड वर्शन intitle%3A है.

उदाहरण

इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के टाइटल में "Google" शब्द दिखना चाहिए. साथ ही, "खोज" शब्द इन दस्तावेज़ों के टाइटल, यूआरएल, लिंक या बॉडी टेक्स्ट में कहीं भी दिखना चाहिए:
उपयोगकर्ता का इनपुट:intitle:Google search
क्वेरी शब्द:q=intitle%3AGoogle+search


टाइटल सर्च, सभी शब्द [allintitle:]
जानकारी

allintitle: क्वेरी के शब्द का इस्तेमाल करने पर, खोज के नतीजे सिर्फ़ उन दस्तावेज़ों तक सीमित हो जाते हैं जिनमें दस्तावेज़ के टाइटल में मौजूद क्वेरी के सभी शब्द शामिल होते हैं. allintitle: क्वेरी शब्द का इस्तेमाल करने के लिए, अपनी खोज क्वेरी की शुरुआत में "allintitle:" शामिल करें.

ध्यान दें: किसी खोज क्वेरी की शुरुआत में allintitle: लगाना, खोज क्वेरी में हर शब्द से पहले intitle: डालने के बराबर है.

allintitle: का यूआरएल-एस्केप्ड वर्शन allintitle%3A है.

उदाहरण

इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के टाइटल में, "Google" और "खोज" शब्द दिखने चाहिए:
उपयोगकर्ता का इनपुट: allintitle: Google search
क्वेरी शब्द: q=allintitle%3A+Google+search


URL खोज, एक शब्द [inurl:]
जानकारी

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

inurl: क्वेरी शब्द में विराम चिह्न को नज़रअंदाज़ किया जाता है और inurl: ऑपरेटर के बाद आने वाले सिर्फ़ पहले शब्द का इस्तेमाल किया जाता है. दस्तावेज़ के यूआरएल में एक से ज़्यादा शब्द शामिल किए जा सकते हैं. इसके लिए, आपको ऐसे हर शब्द के आगे inurl: क्वेरी शब्द डालना होगा. यह बताने के लिए भी allinurl: क्वेरी का इस्तेमाल किया जा सकता है कि क्वेरी के सभी शब्दों को, खोज के नतीजों में मौजूद दस्तावेज़ों के यूआरएल में शामिल किया जाना चाहिए.

inurl: का यूआरएल-एस्केप्ड वर्शन inurl%3A है.

उदाहरण

इस उदाहरण से पता चलता है कि खोज के नतीजों में किसी भी दस्तावेज़ के यूआरएल में "Google" शब्द दिखना चाहिए. साथ ही, "खोज" शब्द उन दस्तावेज़ों के टाइटल, यूआरएल, लिंक या मुख्य हिस्से में कहीं भी दिखना चाहिए:
उपयोगकर्ता का इनपुट: inurl:Google search
क्वेरी शब्द: q=inurl%3AGoogle+search


यूआरएल सर्च, सभी शब्द [allinurl:]
जानकारी

allinurl: क्वेरी के शब्द का इस्तेमाल करने पर, खोज के नतीजे सिर्फ़ उन दस्तावेज़ों तक सीमित हो जाते हैं जिनमें दस्तावेज़ के यूआरएल में शामिल क्वेरी के सभी शब्द शामिल होते हैं. allinurl: क्वेरी शब्द का इस्तेमाल करने के लिए, अपनी खोज क्वेरी की शुरुआत में allinurl: शामिल करें.

allinurl: क्वेरी के लिए इस्तेमाल होने वाले शब्द में विराम चिह्न को शामिल नहीं किया जाता. इसलिए, यह सिर्फ़ शब्दों पर काम करता है, यूआरएल के कॉम्पोनेंट पर नहीं. उदाहरण के लिए, allinurl: uk/scotland नतीजों को उन दस्तावेज़ों तक ही सीमित कर देगा जिनके यूआरएल में "uk" और "scotland" शब्द शामिल हैं. हालांकि, इसके लिए ज़रूरी नहीं है कि वे दोनों शब्द किसी खास क्रम में दिखें या उन्हें स्लैश से अलग किया जाए.

allinurl: का यूआरएल-एस्केप्ड वर्शन allinurl%3A है.

उदाहरण

इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के यूआरएल में, "Google" और "खोज" शब्द दिखने चाहिए:
उपयोगकर्ता का इनपुट: allinurl: Google search
क्वेरी शब्द: q=allinurl%3A+Google+search



वेब दस्तावेज़ की जानकारी [जानकारी:]
जानकारी

info: क्वेरी शब्द का इस्तेमाल, यूआरएल के बारे में सामान्य जानकारी पाने के लिए किया जाता है. ऐसा तब तक होता है, जब तक वह यूआरएल Google के Search इंडेक्स में मौजूद रहता है. खोज क्वेरी को info:URL के तौर पर फ़ॉर्मैट किया जाना चाहिए. साथ ही, info: क्वेरी शब्द और यूआरएल के बीच कोई स्पेस नहीं होना चाहिए.

info: का यूआरएल-एस्केप्ड वर्शन info%3A है.

ध्यान दें: info: का इस्तेमाल करते समय, क्वेरी के लिए कोई और शब्द नहीं बताया जा सकता.

उदाहरण उपयोगकर्ता का इनपुट: info:www.google.com
क्वेरी के लिए शब्द: q=info%3Awww.google.com

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

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

यह अनुरोध, फ़ाइल टाइप .png के लिए क्वेरी शब्द "बंदर" (q=monkey) के लिए पहले 5 नतीजे (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

इमेज खोज क्वेरी पैरामीटर

as_filetype
जानकारी

Optional. किसी खास टाइप की इमेज दिखाता है. इन वैल्यू का इस्तेमाल किया जा सकता है: bmp, gif, png, jpg, और svg.

उदाहरण q=google&as_filetype=png

इमेज
जानकारी

Optional. किसी खास साइज़ की इमेज दिखाता है, जहां साइज़ इनमें से कोई एक हो सकता है:

  • icon (छोटा)
  • small|medium|large|xlarge (मीडियम)
  • xxlarge (बड़ा)
  • huge (ज़्यादा बड़ा)

उदाहरण q=google&as_filetype=png&imgsz=icon

imgtype
जानकारी

Optional. इस तरह की इमेज दिखाता है जो इनमें से कोई एक हो सकती है:

  • clipart (क्लिपार्ट)
  • face (चेहरा)
  • lineart (लीनियर)
  • news (समाचार)
  • photo (फ़ोटो)

उदाहरण q=google&as_filetype=png&imgtype=photo

इमेजसी
जानकारी

Optional. ब्लैक ऐंड व्हाइट, ग्रेस्केल या कलर इमेज दिखाता है:

  • mono (ब्लैक ऐंड व्हाइट)
  • gray (ग्रेस्केल)
  • color (रंग)

उदाहरण q=google&as_filetype=png&imgc=gray

इमेज का रंग
जानकारी

Optional. किसी खास मुख्य रंग की इमेज दिखाता है:

  • yellow
  • green
  • teal
  • blue
  • purple
  • pink
  • white
  • gray
  • black
  • brown
उदाहरण q=google&as_filetype=png&imgcolor=yellow

as_rights
जानकारी

Optional. लाइसेंस देने के हिसाब से फ़िल्टर. ये वैल्यू इस्तेमाल की जा सकती हैं:

  • cc_publicdomain
  • cc_attribute
  • cc_sharealike
  • cc_noncommercial
  • cc_nonderived

उदाहरण q=cats&as_filetype=png&as_rights=cc_attribute

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

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

कॉम्पोनेंट सीमा Comment
खोज के लिए किए गए अनुरोध की संख्या 2048 बाइट  
क्वेरी के लिए इस्तेमाल किए गए शब्दों की संख्या 10 इन पैरामीटर में शब्द शामिल होते हैं: q, as_epq, as_eq, as_lq, as_oq, as_q
परिणामों की संख्या 20 अगर num पैरामीटर को 20 से बड़ी संख्या पर सेट किया जाता है, तो सिर्फ़ 20 नतीजे दिखते हैं. ज़्यादा नतीजे पाने के लिए, आपको कई अनुरोध भेजने होंगे. साथ ही, आपको हर अनुरोध के साथ, start पैरामीटर की वैल्यू बढ़ानी होगी.

क्वेरी और नतीजों के प्रज़ेंटेशन को अंतरराष्ट्रीय बनाना

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

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

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

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

अपने एचटीटीपी अनुरोध में, वर्णों को कोड में बदलने का तरीका तय करने के लिए, ie अनुरोध पैरामीटर का इस्तेमाल किया जा सकता है. आपके एक्सएमएल रिस्पॉन्स को कोड में बदलने के लिए, Google को जिस एन्कोडिंग स्कीम का इस्तेमाल करना चाहिए उसके बारे में बताने के लिए, oe पैरामीटर का इस्तेमाल भी किया जा सकता है. अगर 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 उस साइट के सभी नतीजे न दिखाए. यह भी हो सकता है कि नतीजों को
    रैंकिंग में नीचे न दिखाया जाए.

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

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

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

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

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

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


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

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

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

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

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

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

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

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

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

डच
अंग्रेज़ी
फ़्रेंच
जर्मन
इटैलियन
पॉर्चगीज़ (ब्राज़ीलियन)
स्पैनिश
ट्रेडिशनल चाइनीज़

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

सेफ़ सर्च का लेवल ब्यौरा
ज़्यादा स्कोर सुरक्षित खोज के ज़्यादा सख्त वर्शन को चालू करती है.
medium पॉर्नोग्राफ़ी और दूसरे अश्लील सेक्शुअल कॉन्टेंट वाले वेब पेजों को ब्लॉक करती है.
बंद है वयस्कों के लिए बने कॉन्टेंट को खोज के नतीजों से फ़िल्टर नहीं करता है.

* सेफ़ सर्च की डिफ़ॉल्ट सेटिंग बंद है.

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

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

Google XML परिणाम DTD

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

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

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

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

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

<!DOCTYPE GSP SYSTEM "google.dtd">

नए DTD को http://www.google.com/google.dtd पर ऐक्सेस करें.

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

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

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

    वर्ण एस्केप्ड फ़ॉर्म इकाई वर्ण कोड
    एंपरसैंड और &amp; &#38;
    सिंगल कोट ' &apos; &#39;
    डबल कोट " &quot; &#34;
    इससे ज़्यादा > &gt; &#62;
    इससे कम < &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>

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

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

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

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

? = वैकल्पिक सबटैग
* = सबटैग के शून्य या इससे ज़्यादा इंस्टेंस
+ = सबटैग के एक या इससे ज़्यादा इंस्टेंस
A B C D G मैं ली सो सवाल R T U X

anchor_text
परिभाषा

<anchor_text> टैग, उस टेक्स्ट के बारे में बताता है जिसे आपको खोज के नतीजे के सेट से जुड़े रिफ़ाइनमेंट लेबल की पहचान करने के लिए, उपयोगकर्ताओं को दिखाना चाहिए. रिफ़ाइन करने के लेबल, बिना अक्षर और अंकों वाले वर्णों को अंडरस्कोर से बदल देते हैं. इसलिए, आपको अपने यूज़र इंटरफ़ेस में <label> टैग की वैल्यू नहीं दिखानी चाहिए. इसके बजाय, आपको <anchor_text> टैग की वैल्यू दिखानी चाहिए.

उदाहरण <anchor_text>गॉल्फ़ कोर्स</anchor_text>
इसका सबटैग FacetItem
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

ब्लॉक करें
परिभाषा

यह टैग प्रमोशन के नतीजे की बॉडी लाइन में किसी ब्लॉक के कॉन्टेंट को इकट्ठा करता है. हर ब्लॉक में T, U, और L सब-टैग होते हैं. खाली T टैग से पता चलता है कि ब्लॉक में टेक्स्ट मौजूद है. खाली U और L टैग से पता चलता है कि ब्लॉक में एक लिंक मौजूद है. इसका यूआरएल U सबटैग में और L सब-टैग में ऐंकर टेक्स्ट दिया गया है.

सबटैग T, U, L
इसका सबटैग BODY_LINE
कॉन्टेंट फ़ॉर्मैट खाली

BODY_LINE
परिभाषा

यह टैग प्रमोट किए गए नतीजे के मुख्य भाग में किसी लाइन का कॉन्टेंट इकट्ठा करता है. हर बॉडी लाइन में कई ब्लॉक टैग होते हैं. इनमें कुछ टेक्स्ट या एक लिंक, यूआरएल और ऐंकर टेक्स्ट मौजूद होता है.

सबटैग ब्लॉक*
इसका सबटैग SL_MAIN
कॉन्टेंट फ़ॉर्मैट खाली

C
परिभाषा

<C> टैग से पता चलता है कि WebSearch सेवा, इस खोज नतीजे के यूआरएल का कैश मेमोरी में सेव किया गया वर्शन वापस ले सकती है. एक्सएमएल एपीआई की मदद से, कैश मेमोरी में सेव किए गए पेजों को वापस नहीं लाया जा सकता. हालांकि, इस कॉन्टेंट के लिए, उपयोगकर्ताओं को www.google.com पर रीडायरेक्ट किया जा सकता है.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
SZ टेक्स्ट (पूरी संख्या + "k") खोज नतीजे के कैश मेमोरी में सेव किए गए वर्शन का साइज़, किलोबाइट ("k") में देता है.
सीआईडी टेक्स्ट Google की कैश मेमोरी में मौजूद दस्तावेज़ की पहचान करता है. कैश मेमोरी से दस्तावेज़ को फ़ेच करने के लिए, खोज के लिए कोई ऐसा शब्द भेजें जो इस तरह बनाया गया हो:
cache:CIDtext:escapedURL

एस्केप किया गया यूआरएल, UE टैग में उपलब्ध होता है.

उदाहरण <C SZ="6k" CID="kvOXK_cYSSgJ" />
इसका सबटैग HAS
कॉन्टेंट फ़ॉर्मैट खाली

सी2सी
परिभाषा <C2C> टैग से पता चलता है कि नतीजा, पारंपरिक चाइनीज़ भाषा के पेज का है. यह टैग सिर्फ़ तब दिखता है, जब सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ सर्च चालू हो. इस सुविधा को चालू और बंद करने के बारे में ज़्यादा जानकारी के लिए, c2coff क्वेरी पैरामीटर की परिभाषा देखें.
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

संदर्भ
परिभाषा

<Context> टैग, खोज के नतीजों के सेट से जुड़े बेहतर बनाने वाले लेबल की सूची को इकट्ठा करता है.

उदाहरण <Context>
सबटैग शीर्षक, मुखिका+
कॉन्टेंट फ़ॉर्मैट कंटेनर

CRAWLDATE
परिभाषा

<CRAWLDATE> टैग उस तारीख की पहचान करता है जब पेज को पिछली बार क्रॉल किया गया था. CRAWLDATE खोज नतीजों के हर पेज के लिए नहीं दिखता है.

उदाहरण <CRAWLDATE>21 मई, 2005</CRAWLDATE>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

डीआई
परिभाषा

<DI> टैग, खोज के किसी एक नतीजे के लिए, Open डायरेक्ट्री प्रोजेक्ट (ODP) की कैटगरी की जानकारी इकट्ठा करता है.

उदाहरण <DI>
सबटैग DT?, DS?
इसका सबटैग HAS
कॉन्टेंट फ़ॉर्मैट खाली

DS
परिभाषा

<DS> टैग, ODP डायरेक्ट्री में किसी एक कैटगरी के लिए लिस्ट की गई खास जानकारी देता है.

उदाहरण <DS>अपने &lt;b&gt;soccer&lt;/b&gt; को सीधे इंटरनेट पर फिर से शुरू करें</DS>
इसका सबटैग डीआई
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (एचटीएमएल हो सकता है)

डीटी
परिभाषा

<DT> टैग, ODP डायरेक्ट्री में दी गई एक कैटगरी का टाइटल देता है.

उदाहरण <DT>SccerConnection.net</DT>
इसका सबटैग डीआई
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (एचटीएमएल हो सकता है)

मुखिका
परिभाषा

<Facet> टैग में <FacetItem> टैग का लॉजिकल ग्रुपिंग होता है. इन ग्रुप को Programmable Search Engine Engine एक्सएमएल स्पेसिफ़िकेशन फ़ॉर्मैट का इस्तेमाल करके बनाया जा सकता है. अगर ये ग्रुप नहीं बनाए जाते हैं, तो results_xml_tag_Context><Context> टैग में ज़्यादा से ज़्यादा चार <Facet> टैग होंगे. हर <Facet> टैग में मौजूद आइटम को डिसप्ले के मकसद से ग्रुप किया जाएगा, लेकिन हो सकता है कि उनका लॉजिकल संबंध न हो.

उदाहरण <Facet>
सबटैग FacetItem+, title+
इसका सबटैग संबंधित जानकारी
कॉन्टेंट फ़ॉर्मैट कंटेनर

FacetItem
परिभाषा

<FacetItem> टैग में खोज के नतीजों के सेट से जुड़े रिफ़ाइनमेंट लेबल के बारे में जानकारी शामिल होती है.

उदाहरण <FacetItem>
सबटैग लेबल, anchor_text+
इसका सबटैग फ़ेससेट
कॉन्टेंट फ़ॉर्मैट FacetItem

FI
परिभाषा <FI> टैग एक फ़्लैग के तौर पर काम करता है. इससे पता चलता है कि खोज के लिए, दस्तावेज़ को फ़िल्टर किया गया था या नहीं. Google के खोज नतीजों के फ़िल्टर के बारे में ज़्यादा जानकारी के लिए, इस दस्तावेज़ का अपने-आप फ़िल्टर करना सेक्शन देखें.
उदाहरण <FI />
इसका सबटैग रिज़ॉल्यूशन
कॉन्टेंट फ़ॉर्मैट खाली

GSP
परिभाषा

<GSP> टैग, Google XML के खोज नतीजों में दिखाए गए पूरे डेटा को इकट्ठा करता है. "GSP", "Google Search प्रोटोकॉल" का छोटा नाम है.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
वर्शन टेक्स्ट (पूरी संख्या) VER एट्रिब्यूट खोज नतीजों के आउटपुट के वर्शन के बारे में बताता है. मौजूदा आउटपुट वर्शन "3.2" है.
उदाहरण <GSP VER="3.2">
सबटैग PARAM+, Q, RES?, TM
कॉन्टेंट फ़ॉर्मैट खाली

HAS
परिभाषा <HAS> टैग किसी खास यूआरएल के लिए काम करने वाले, किसी भी खास खोज अनुरोध पैरामीटर की जानकारी को इकट्ठा करता है.

ध्यान दें: WebSearch के लिए <HAS> की परिभाषा, DTD से ज़्यादा सीमित है.

सबटैग डीआई?, L?, C?, RT?
इसका सबटैग R

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

L
परिभाषा <L> टैग होने का मतलब है कि WebSearch सेवा, खोज के इस नतीजे के यूआरएल से जुड़ी अन्य साइटें ढूंढ सकती है. ऐसी साइटें ढूंढने के लिए, आपको इस लिंक: खास क्वेरी शब्द का इस्तेमाल करना होगा.
इसका सबटैग HAS
कॉन्टेंट फ़ॉर्मैट खाली

लेबल
परिभाषा

<label> टैग, बेहतर बनाने के लेबल के बारे में बताता है. इसका इस्तेमाल, आपको मिलने वाले खोज के नतीजों को फ़िल्टर करने के लिए किया जा सकता है. रिफ़ाइन करने का लेबल इस्तेमाल करने के लिए, Google को भेजे गए अपने एचटीटीपी अनुरोध में, q पैरामीटर की वैल्यू में ज़्यादा:[[label टैग वैल्यू]] स्ट्रिंग जोड़ें. इसका उदाहरण नीचे दिया गया है. कृपया ध्यान दें कि Google को क्वेरी भेजने से पहले, इस वैल्यू को यूआरएल-एस्केप्ड होना चाहिए.

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

ध्यान दें: <label> टैग और <Label> टैग अलग-अलग हैं. यह टैग, खोज नतीजों में किसी खास यूआरएल के साथ जुड़े रिफ़ाइनमेंट लेबल की पहचान करता है.

उदाहरण <label>गॉल्फ़_कोर्स</label>
इसका सबटैग FacetItem
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

भाषा
परिभाषा

<LANG> टैग में, खोज के नतीजों की भाषा के लिए Google का सबसे अच्छा अनुमान होता है.

उदाहरण <LANG>en</LANG>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

सोम
परिभाषा

<M> टैग, खोज के नतीजों की कुल अनुमानित संख्या की पहचान करता है.

ध्यान दें: हो सकता है कि यह अनुमान सटीक न हो.

उदाहरण <M>16200000</M>
इसका सबटैग रिज़ॉल्यूशन
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

NB
परिभाषा

<NB> टैग, नेविगेशन की जानकारी को इकट्ठा करता है. यह जानकारी, खोज के नतीजों के सेट के लिए, खोज नतीजों के अगले पेज या खोज नतीजों के पिछले पेज पर ले जाती है.

ध्यान दें: यह टैग सिर्फ़ तब दिखता है, जब ज़्यादा नतीजे उपलब्ध हों.

उदाहरण <NB>
सबटैग NU?, PU?
इसका सबटैग रिज़ॉल्यूशन
कॉन्टेंट फ़ॉर्मैट खाली

NU
परिभाषा

<NU> टैग में, खोज के नतीजों के अगले पेज का एक मिलता-जुलता लिंक शामिल होता है.

उदाहरण <NU>/search?q=flowers&num=10&hl=en&ie=UTF-8
&आउटपुट=xml&client=test&start=10</NU>
इसका सबटैग एनबी
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (सापेक्ष URL)

पैरामीटर
परिभाषा

<PARAM> टैग, एक्सएमएल नतीजे से जुड़े एचटीटीपी अनुरोध में सबमिट किए गए इनपुट पैरामीटर की पहचान करता है. पैरामीटर की जानकारी टैग एट्रिब्यूट—नाम, मान, origin_value—में शामिल होती है और एचटीटीपी अनुरोध में सबमिट किए गए हर पैरामीटर के लिए एक PARAM टैग होगा.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
name टेक्स्ट इनपुट पैरामीटर का नाम.
वैल्यू एचटीएमएल इनपुट पैरामीटर वैल्यू का एचटीएमएल फ़ॉर्मैट वाला वर्शन.
original_value टेक्स्ट इनपुट पैरामीटर वैल्यू का ओरिजनल यूआरएल-एस्केप्ड वर्शन.
उदाहरण <PARAM name="cr" value="countryNZ" origin_value="countryNZ" />
इसका सबटैग जीएसपी
कॉन्टेंट फ़ॉर्मैट Complex

पीयू
परिभाषा

<PU> टैग, खोज के नतीजों के पिछले पेज का लिंक दिखाता है.

उदाहरण <PU>/search?q=flowers&num=10&hl=en&extension=xml
&client=test&start=10</PU>
इसका सबटैग एनबी
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (सापेक्ष URL)

सवाल
परिभाषा

<Q> टैग, एक्सएमएल नतीजे से जुड़े एचटीटीपी अनुरोध में सबमिट की गई खोज क्वेरी की पहचान करता है.

उदाहरण

<Q>pizza</Q>

इसका सबटैग जीएसपी
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

R
परिभाषा

<R> टैग में, खोज के किसी खास नतीजे की जानकारी शामिल होती है.

ध्यान दें: WebSearch के लिए <R> टैग की परिभाषा, DTD के मुकाबले ज़्यादा पाबंदी वाली है.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
N टेक्स्ट (पूरी संख्या) इस खोज नतीजे के इंडेक्स (1-आधारित) को दिखाता है.
MIME टेक्स्ट यह दिखाता है कि खोज के नतीजे का MIME टाइप किस तरह का है.
सबटैग U, UE, T?, CRAWLDATE, S?, lang?, HAS
इसका सबटैग रिज़ॉल्यूशन

आरईएस
परिभाषा

<RES> टैग में, खोज के अलग-अलग नतीजों के सेट और उन नतीजों की जानकारी शामिल होती है.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
SN टेक्स्ट (पूरी संख्या) यह नतीजे के इस सेट में दिखाए गए पहले खोज के नतीजे के इंडेक्स (1-आधारित) को दिखाता है.
HI टेक्स्ट (पूरी संख्या) यह इस नतीजे के सेट में दिखाए गए आखिरी खोज के नतीजे के इंडेक्स (1-आधारित) को दिखाता है.
उदाहरण <RES SN="1" EN="10">
सबटैग M, FI?, XT?, NB?, R*
इसका सबटैग जीएसपी
कॉन्टेंट फ़ॉर्मैट खाली

S
परिभाषा

<S> टैग में खोज के नतीजे के लिए एक छोटा हिस्सा होता है. इसमें, क्वेरी के लिए इस्तेमाल किए गए शब्दों को बोल्ड करके दिखाया जाता है. लाइन ब्रेक को टेक्स्ट में सही तरीके से रैप करने के लिए, हिस्से में शामिल किया जाता है.

उदाहरण <S>वॉशिंगटन (CNN) -- राष्ट्रपति &lt;b&gt;Bus&#39;s&lt;/b&gt; न्यायिक चुनाव से पांच उम्मीदवारों को अंतिम मतदान के लिए आगे बढ़ने का विकल्प मिलेगा. &lt;b&gt;...&lt;b&gt;...&lt;/b>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (एचटीएमएल)

SL_MAIN
परिभाषा

यह टैग, प्रमोशन के नतीजे का कॉन्टेंट शामिल करता है. प्रमोशन पार्स करने के लिए इस्तेमाल करें. शीर्षक के लिंक का ऐंकर टेक्स्ट और यूआरएल, T और U सबटैग में शामिल होते हैं. मुख्य भाग के लेख और लिंक की पंक्तियां BODY_LINE सबटैग में शामिल हैं.

सबटैग BODY_LINE*, T, U
इसका सबटैग SL_RESULTS
कॉन्टेंट फ़ॉर्मैट खाली

SL_RESULTS
परिभाषा

प्रमोट किए गए नतीजों के लिए कंटेनर टैग. खोज के नतीजों में जब भी कोई प्रमोशन दिखेगा, तो इनमें से कोई एक विकल्प दिखेगा. SL_MAIN सब-टैग में, नतीजे का मुख्य डेटा होता है.

सबटैग SL_MAIN*
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट खाली

वर्तनी (स्पेलिंग)
परिभाषा

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

ध्यान दें: Google, सिर्फ़ उन क्वेरी के लिए स्पेलिंग के सुझाव दिखाएगा जिनमें gl पैरामीटर की वैल्यू अंग्रेज़ी के छोटे अक्षरों में होगी.

उदाहरण <Spelling>
सबटैग सुझाव
इसका सबटैग जीएसपी
कॉन्टेंट फ़ॉर्मैट खाली

सुझाव
परिभाषा <Suggestion> टैग में सबमिट की गई क्वेरी के लिए स्पेलिंग का दूसरा सुझाव दिया जाता है. खोज करने वाले उपयोगकर्ता को वैकल्पिक स्पेलिंग का सुझाव देने के लिए, टैग के कॉन्टेंट का इस्तेमाल किया जा सकता है. q एट्रिब्यूट की वैल्यू, यूआरएल से एस्केप किया गया स्पेलिंग का सुझाव है. इसे क्वेरी के लिए इस्तेमाल किया जा सकता है.
एट्रिब्यूट
नाम फ़ॉर्मैट जानकारी
q टेक्स्ट q एट्रिब्यूट, स्पेलिंग के सुझाव के यूआरएल-एस्केप्ड वर्शन के बारे में बताता है.
उदाहरण <Suggestion q="soccer">&lt;b&gt;&lt;i&gt;soccer&lt;/i&gt;&lt;/b&gt;</Suggestion>
इसका सबटैग वर्तनी (स्पेलिंग)
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (एचटीएमएल)

T
परिभाषा <T> टैग में नतीजे का शीर्षक होता है.
उदाहरण <T>अमीसी का पूर्वी तट पिज़्ज़ेरिया</T>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (एचटीएमएल)

टाइटल
परिभाषा

<Context> का बच्चा होने के नाते, <title> टैग में आपके Programmable Search Engine का नाम होता है.

<Facet> के चाइल्ड के रूप में, <title> टैग पहलुओं के सेट के लिए एक शीर्षक उपलब्ध कराता है.

उदाहरण

<कॉन्टेक्स्ट> के बच्चे के तौर पर: <title>मेरा सर्च इंजन</title>

<Facet> के बच्चे के तौर पर: <title>facet title</title>

इसका सबटैग कॉन्टेक्स्ट, फ़ैसेट
कॉन्टेंट फ़ॉर्मैट टेक्स्ट

TM
परिभाषा

<TM> टैग, खोज के नतीजे दिखाने के लिए सर्वर में लगने वाले कुल समय की पहचान करता है. इसे सेकंड में मापा जाता है.

उदाहरण <TM>0.100445</TM>
इसका सबटैग जीएसपी
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (फ़्लोटिंग-पॉइंट नंबर)

टीटी
परिभाषा <TT> टैग से, खोज के लिए सलाह मिलती है.
उदाहरण <TT>&lt;i&gt;सलाह: ज़्यादातर ब्राउज़र के लिए, रिटर्न बटन दबाने पर, 'खोजें' बटन पर क्लिक करने जैसे नतीजे मिलते हैं.&lt;/i&gt;</TT>
इसका सबटैग जीएसपी

U
परिभाषा <U> टैग, खोज के नतीजे का यूआरएल दिखाता है.
उदाहरण <U>http://www.dominos.com/</U>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (ऐब्सलूट यूआरएल)

यूडी
परिभाषा

<UD> टैग, खोज के नतीजे के लिए आईडीएन से कोड में बदला गया (अंतरराष्ट्रीय डोमेन नाम) यूआरएल देता है. इस वैल्यू की मदद से, डोमेन को स्थानीय भाषाओं में दिखाया जा सकता है. उदाहरण के लिए, आईडीएन कोड में बदले गए यूआरएल http://www.%E8%8A%B1%E4%BA%95.com को डिकोड किया जा सकता है और http://www.花upgrade鮨.com के तौर पर दिखाया जा सकता है. इस <UD> टैग को, सिर्फ़ उन अनुरोधों के लिए खोज के नतीजों में शामिल किया जाएगा जिनमें ud पैरामीटर शामिल होगा.

ध्यान दें: यह बीटा वर्शन की सुविधा है.

उदाहरण <UD>http://www.%E8%8A%B1%E4%BA%95.com/</UD>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (आईडीएन से कोड में बदला गया यूआरएल)

UE
परिभाषा <UE> टैग से, खोज के नतीजे का यूआरएल मिलता है. वैल्यू को यूआरएल-एस्केप्ड है, ताकि यह यूआरएल में क्वेरी पैरामीटर के तौर पर पास करने के लिए सही हो.
उदाहरण <UE>http://www.dominos.com/</UE>
इसका सबटैग R
कॉन्टेंट फ़ॉर्मैट टेक्स्ट (यूआरएल-एस्केप्ड यूआरएल)

एक्सटी
परिभाषा <XT> टैग से पता चलता है कि M टैग में बताए गए नतीजों की कुल अनुमानित संख्या, असल में नतीजों की कुल संख्या के बारे में बताती है. ज़्यादा जानकारी के लिए, इस दस्तावेज़ का अपने-आप फ़िल्टर होने की सुविधा सेक्शन देखें.
उदाहरण <XT />
इसका सबटैग रिज़ॉल्यूशन
कॉन्टेंट फ़ॉर्मैट खाली


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

इमेज के इस अनुरोध का उदाहरण, खोज के लिए इस्तेमाल हुए शब्द "बंदर" (q=monkey) से जुड़े 5 नतीजे (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>

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

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

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

? = वैकल्पिक सबटैग
* = सबटैग के शून्य या इससे ज़्यादा इंस्टेंस
+ = सबटैग के एक या इससे ज़्यादा इंस्टेंस

आरजी
परिभाषा

<RG> टैग में, खोज के किसी एक नतीजे की जानकारी शामिल होती है.

एट्रिब्यूट
नाम फ़ॉर्मैट ब्यौरा
N टेक्स्ट (पूरी संख्या) इस खोज नतीजे के इंडेक्स (1-आधारित) को दिखाता है.
MIME टेक्स्ट यह दिखाता है कि खोज के नतीजे का MIME टाइप किस तरह का है.
इसका सबटैग रिज़ॉल्यूशन
रूस
परिभाषा

<RU tag> टैग में, खोज के हर नतीजे की जानकारी शामिल होती है.

इसका सबटैग R