यह पेज, कस्टम खोज JSON एपीआई के एक्सएमएल वर्शन को दिखाता है, जो सिर्फ़ Google Site Search के ग्राहकों के लिए उपलब्ध है.
- खास जानकारी
- Programmable Search Engine के अनुरोध का फ़ॉर्मैट
- एक्सएमएल के नतीजे
खास जानकारी
Google WebSearch सेवा की मदद से, Google Site Search के ग्राहक अपनी वेबसाइटों पर Google के खोज नतीजे दिखा सकते हैं. Search के नतीजे दिखाने के लिए, WebSearch सेवा, एचटीटीपी पर आधारित एक आसान प्रोटोकॉल का इस्तेमाल करती है. सर्च एडमिन के पास इस बात का पूरा कंट्रोल होता है कि वे खोज के नतीजों के लिए किस तरह अनुरोध करें. साथ ही, उन नतीजों को असली उपयोगकर्ता को किस तरह से दिखाया जाए. इस दस्तावेज़ में, Google पर खोज के अनुरोध और नतीजों के फ़ॉर्मैट की तकनीकी जानकारी दी गई है.
Google WebSearch के नतीजे पाने के लिए, आपका ऐप्लिकेशन Google को एक आसान एचटीटीपी अनुरोध भेजता है. इसके बाद, Google एक्सएमएल फ़ॉर्मैट में खोज के नतीजे दिखाता है. एक्सएमएल फ़ॉर्मैट वाले नतीजों की मदद से, खोज के नतीजों को अपनी पसंद के मुताबिक दिखाया जा सकता है.
WebSearch अनुरोध का फ़ॉर्मैट
- अनुरोध की खास जानकारी
- क्वेरी की शर्तें
- अनुरोध पैरामीटर
- वेबखोज क्वेरी का नमूना
- 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 पैरामीटर की मदद से, सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ सर्च की सुविधा को चालू या बंद किया जा सकता है. इस पैरामीटर की डिफ़ॉल्ट वैल्यू
|
||||||
उदाहरण | q=google&c2coff=1 |
क्लाइंट | |
---|---|
जानकारी | ज़रूरी है. |
उदाहरण | q=google&client=google-csbe |
cr | |
---|---|
जानकारी | Optional. Google Web Search, विश्लेषण करके यह पता लगाता है कि दस्तावेज़ किस देश का है:
इस पैरामीटर के लिए मान्य वैल्यू की सूची देखने के लिए, देश (cr) पैरामीटर की वैल्यू सेक्शन देखें. |
उदाहरण | q=Frodo&cr=countryNZ |
cx | |
---|---|
जानकारी | ज़रूरी है. |
उदाहरण | q=Frodo&cx=00255077836266642015:u-scht7a-8i |
फ़िल्टर | |||||||
---|---|---|---|---|---|---|---|
जानकारी | Optional. filter पैरामीटर, Google पर खोज नतीजों को अपने-आप फ़िल्टर करने की सुविधा को चालू या बंद करता है. Google के खोज नतीजों के फ़िल्टर के बारे में ज़्यादा जानकारी के लिए, इस दस्तावेज़ का अपने-आप फ़िल्टर करना सेक्शन देखें.
ध्यान दें: डिफ़ॉल्ट रूप से, Google खोज के सभी नतीजों पर फ़िल्टर लागू करके, खोज के उन नतीजों की क्वालिटी को बेहतर बनाता है. |
||||||
उदाहरण | q=google&filter=0 |
gl | |
---|---|
जानकारी | Optional. WebSearch के अनुरोधों में |
उदाहरण | यह अनुरोध, यूनाइटेड किंगडम में लिखे गए दस्तावेज़ों को WebSearch के नतीजों में शामिल करता है: |
hl | |
---|---|
जानकारी | Optional. ज़्यादा जानकारी के लिए, अंतरराष्ट्रीय क्वेरी करने और नतीजों का प्रज़ेंटेशन का इंटरफ़ेस भाषाएं सेक्शन देखें. साथ ही, इस्तेमाल की जा सकने वाली भाषाओं की सूची देखने के लिए, इंटरफ़ेस पर काम करने वाली भाषाएं देखें. |
उदाहरण | यह अनुरोध फ़्रेंच भाषा की वाइन के विज्ञापनों को टारगेट करता है. (Vin, वाइन के लिए फ़्रेंच है.) q=vin&ip=10.10.10.10&ad=w5&hl=fr |
अच्छी क्वालिटी | |
---|---|
जानकारी | Optional. |
उदाहरण | यह अनुरोध 'पिज़्ज़ा' AND 'चीज़' के लिए खोजता है. एक्सप्रेशन
|
ie | |
---|---|
जानकारी | Optional. इस पैरामीटर का इस्तेमाल कब करना पड़ सकता है, इस बारे में जानने के लिए वर्ण एन्कोडिंग सेक्शन देखें. संभावित |
उदाहरण | q=google&ie=utf8&oe=utf8 |
lr | |
---|---|
जानकारी | Optional. Google Web Search, विश्लेषण करके किसी दस्तावेज़ की भाषा तय करता है:
इस पैरामीटर के लिए मान्य वैल्यू की सूची के लिए, भाषा ( |
उदाहरण | q=Frodo&lr=lang_en |
num | |
---|---|
जानकारी | Optional.
ध्यान दें: अगर खोज के नतीजों की कुल संख्या, मांगे गए नतीजों की संख्या से कम है, तो सभी उपलब्ध खोज नतीजे दिखाए जाएंगे. |
उदाहरण | q=google&num=10 |
oe | |
---|---|
जानकारी | Optional. इस पैरामीटर का इस्तेमाल कब करना पड़ सकता है, इस बारे में जानने के लिए वर्ण एन्कोडिंग सेक्शन देखें. संभावित |
उदाहरण | q=google&ie=utf8&oe=utf8 |
आउटपुट | |||||||
---|---|---|---|---|---|---|---|
जानकारी | ज़रूरी है.
|
||||||
उदाहरण | output=xml_no_dtd |
q | |
---|---|
जानकारी | Optional. क्वेरी में ऐसे कई खास शब्द भी हैं जिनका इस्तेमाल Google Search के कंट्रोल पैनल में, ध्यान दें: q पैरामीटर के लिए तय की गई वैल्यू, यूआरएल-एस्केप्ड होनी चाहिए. |
उदाहरण | q=vacation&as_oq=london+paris |
सुरक्षित | |||||||||
---|---|---|---|---|---|---|---|---|---|
जानकारी | Optional.
इस सुविधा के बारे में ज़्यादा जानने के लिए, सेफ़ सर्च की मदद से वयस्कों के लिए बने कॉन्टेंट को फ़िल्टर करना सेक्शन देखें. |
||||||||
उदाहरण | q=adult&safe=high |
शुरू करें | |
---|---|
जानकारी | Optional.
|
उदाहरण | start=10 |
क्रम से लगाएं | |
---|---|
जानकारी | Optional. |
उदाहरण |
|
Ud | |
---|---|
जानकारी | Optional. http://www.花井鮨.com इस पैरामीटर के लिए सही वैल्यू अगर http://www.xn--elq438j.com. ध्यान दें: यह बीटा वर्शन की सुविधा है. |
उदाहरण | q=google&ud=1 |
बेहतर खोज
इमेज के नीचे दिए गए अतिरिक्त क्वेरी पैरामीटर, बेहतर खोज क्वेरी के लिए काम के होते हैं. जब बेहतर खोज को सबमिट किया जाता है, तब कई पैरामीटर (जैसे, as_eq, as_epq, as_oq वगैरह) की वैल्यू, उस खोज के लिए क्वेरी के लिए इस्तेमाल किए जाने वाले शब्दों में शामिल की जाती हैं. इस इमेज में Google का ऐडवांस खोज वाला पेज दिखाया गया है. इमेज पर, हर बेहतर खोज पैरामीटर का नाम उस पेज पर फ़ील्ड के अंदर या उसके बगल में red टेक्स्ट में लिखा होता है जिससे वह पैरामीटर मेल खाता है.
बेहतर खोज क्वेरी पैरामीटर
as_dt | |
---|---|
जानकारी | Optional. |
उदाहरण | as_dt=i,as_dt=e |
as_epq | |
---|---|
जानकारी | Optional. |
उदाहरण | as_epq=abraham+lincoln |
as_eq | |
---|---|
जानकारी | Optional. |
उदाहरण |
|
as_lq | |
---|---|
जानकारी | Optional. |
उदाहरण |
|
as_nlo | |
---|---|
जानकारी | Optional. |
उदाहरण | नीचे 5 से 10 की खोज रेंज सेट की गई है, जिसमें ये भी शामिल हैं:
|
as_nhi | |
---|---|
जानकारी | Optional. |
उदाहरण | नीचे 5 से 10 की खोज रेंज सेट की गई है, जिसमें ये भी शामिल हैं:
|
as_oq | |
---|---|
जानकारी | Optional. किसी दस्तावेज़ में जांच करने के लिए, |
उदाहरण |
|
as_q | |
---|---|
जानकारी | Optional. |
उदाहरण |
|
as_qdr | |
---|---|
जानकारी | Optional.
|
उदाहरण |
इस उदाहरण में, पिछले साल के नतीजों का अनुरोध किया गया है:
इस उदाहरण में, पिछले 10 दिनों के नतीजों के लिए अनुरोध किया गया है:
|
as_sitesearch | |
---|---|
जानकारी | Optional. |
उदाहरण |
|
विशेष क्वेरी शब्द
Google WebSearch में, क्वेरी के लिए ऐसे कई खास शब्दों का इस्तेमाल किया जा सकता है जिनसे Google के सर्च इंजन की अन्य सुविधाएं ऐक्सेस की जा सकती हैं. क्वेरी के ये खास शब्द, q अनुरोध पैरामीटर की वैल्यू में शामिल किए जाने चाहिए. क्वेरी के अन्य शब्दों की तरह, क्वेरी के लिए खास शब्द यूआरएल-एस्केप्ड होने चाहिए. कुछ खास क्वेरी शब्दों में कोलन (:) होता है. इस वर्ण का नाम यूआरएल से एस्केप होना चाहिए, जबकि इसकी यूआरएल-एस्केप्ड वैल्यू %3A
है.
बैक लिंक [link:] | |
---|---|
जानकारी |
ध्यान दें: |
उदाहरण |
|
बूलियन या खोज [ OR ] | |
---|---|
जानकारी |
शब्दों के किसी सेट में मौजूद किसी शब्द की खोज को सबमिट करने के लिए, as_oq अनुरोध पैरामीटर का भी इस्तेमाल किया जा सकता है. ध्यान दें: अगर खोज के अनुरोध में, "London+OR+Paris" क्वेरी का पता चलता है, तो खोज के नतीजों में ऐसे दस्तावेज़ भी शामिल होंगे जिनमें उन दोनों शब्दों में से कम से कम एक शब्द मौजूद हो. कुछ मामलों में, खोज के नतीजों में मौजूद दस्तावेज़ों में दोनों शब्द हो सकते हैं. |
उदाहरण | लंदन या पेरिस खोजें: उपयोगकर्ता का इनपुट:
london OR
paris क्वेरी के लिए शब्द:q=london+OR+paris छुट्टियां बिताने के लिए, लंदन या पेरिस में से किसी एक जगह को खोजें: क्वेरी के लिए शब्द:
q=vacation+london+OR+paris छुट्टियां और लंदन, पेरिस या चॉकलेट में से कोई एक खोजें: क्वेरी के लिए शब्द:
q=vacation+london+OR+paris+OR+chocolates छुट्टी और चॉकलेट के साथ-साथ लंदन या पेरिस में भी खोजें, जिसमें चॉकलेट को सबसे कम वज़न दिया गया हो: क्वेरी के लिए शब्द:
q=vacation+london+OR+paris+chocolates उन दस्तावेज़ों में छुट्टियां, चॉकलेट, और फूल खोजें जिनमें लंदन या पेरिस भी शामिल हो: क्वेरी के लिए शब्द:
q=vacation+london+OR+paris+chocolates+flowers छुट्टियां और लंदन या पेरिस में से कोई एक खोजें और साथ ही चॉकलेट या फूलों में से कोई एक खोजें: क्वेरी के लिए शब्द: q=vacation+london+OR+paris+chocolates+OR+flowers |
क्वेरी शब्द [-] बाहर रखें | |
---|---|
जानकारी | बाहर रखें (
क्वेरी को बाहर रखने वाला शब्द तब काम का होता है, जब खोज के लिए इस्तेमाल हुए शब्द के एक से ज़्यादा मतलब होते हैं. उदाहरण के लिए, "बेस" शब्द से मछली या संगीत के बारे में नतीजे मिल सकते हैं. अगर आपको मछली के बारे में दस्तावेज़ चाहिए, तो 'बाहर रखें' क्वेरी शब्द का इस्तेमाल करके, खोज के नतीजों से संगीत से जुड़े दस्तावेज़ों को हटाया जा सकता है. खोज के नतीजों में किसी खास शब्द या वाक्यांश से मेल खाने वाले दस्तावेज़ों को बाहर रखने के लिए, as_eq अनुरोध पैरामीटर का भी इस्तेमाल किया जा सकता है. |
उदाहरण | उपयोगकर्ता का इनपुट: bass -music क्वेरी के लिए शब्द: q=bass+%2Dmusic |
फ़ाइल टाइप एक्सक्लूज़न [ -filetype: ] | |
---|---|
जानकारी |
ध्यान दें: अपनी क्वेरी में ज़्यादा Google जिन फ़ाइल टाइप का इस्तेमाल करता है उनमें ये शामिल हैं:
आने वाले समय में, दूसरे फ़ाइल टाइप जोड़े जा सकते हैं. अप-टू-डेट सूची कभी भी Google के फ़ाइल टाइप के बारे में अक्सर पूछे जाने वाले सवाल में देखी जा सकती है. |
उदाहरण | इस उदाहरण में ऐसे दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है, लेकिन वे PDF दस्तावेज़ नहीं हैं: इस उदाहरण में वे दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है, लेकिन
PDF और Word, दोनों तरह के दस्तावेज़ शामिल नहीं हैं: |
फ़ाइल प्रकार फ़िल्टर करना [ फ़ाइल प्रकार: ] | |
---|---|
जानकारी |
अपनी क्वेरी में डिफ़ॉल्ट रूप से, खोज के नतीजों में किसी भी फ़ाइल एक्सटेंशन वाले दस्तावेज़ शामिल होंगे. Google जिन फ़ाइल टाइप का इस्तेमाल करता है उनमें ये शामिल हैं:
आने वाले समय में, दूसरे फ़ाइल टाइप जोड़े जा सकते हैं. अप-टू-डेट सूची कभी भी Google के फ़ाइल टाइप के बारे में अक्सर पूछे जाने वाले सवाल में देखी जा सकती है. |
उदाहरण | इस उदाहरण में ऐसे PDF दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है: इस उदाहरण में ऐसे PDF और Word दस्तावेज़ दिखाए गए हैं जिनमें "Google" लिखा है: |
क्वेरी शब्द शामिल करें [+] | |
---|---|
जानकारी | शामिल करें (+) क्वेरी शब्द से पता चलता है कि कोई शब्द या वाक्यांश, खोज के नतीजों में शामिल सभी दस्तावेज़ों में होना चाहिए. 'क्वेरी शामिल करें' शब्द का इस्तेमाल करने के लिए, आपको उस शब्द या वाक्यांश की शुरुआत करनी होगी जिसे सभी खोज नतीजों में "+" (प्लस का निशान) के साथ शामिल किया जाना चाहिए.
आपको |
उदाहरण | उपयोगकर्ता का इनपुट: Star Wars Episode +I क्वेरी के लिए शब्द: q=Star+Wars+Episode+%2BI |
केवल लिंक खोज, सभी शब्द [ Allinlinks: ] | |
---|---|
जानकारी |
अगर आपकी खोज क्वेरी में
|
उदाहरण | उपयोगकर्ता का इनपुट:allinlinks: Google search क्वेरी के लिए शब्द: q=allinlinks%3A+Google+search |
वाक्यांश खोज | |
---|---|
जानकारी | फ़्रेज़ सर्च (") की क्वेरी वाले शब्द की मदद से, पूरे वाक्यांश खोजे जा सकते हैं. इसके लिए, वाक्यांशों को कोटेशन मार्क के अंदर रखें या उन्हें हाइफ़न से जोड़ें.
वाक्यांश की खोज खास तौर पर तब मददगार होती है, जब आप मशहूर कोटेशन या सही नामों को खोज रहे हों. फ़्रेज़ खोज को सबमिट करने के लिए, as_epq अनुरोध पैरामीटर का भी इस्तेमाल किया जा सकता है. |
उदाहरण | उपयोगकर्ता का इनपुट:"Abraham Lincoln" क्वेरी के लिए शब्द: q=%22Abraham+Lincoln%22 |
सिर्फ़ टेक्स्ट के लिए खोज, सभी शब्द [allintext:] | |
---|---|
जानकारी |
अगर आपकी खोज क्वेरी में
|
उदाहरण | इस उदाहरण से पता चलता है कि
"Google" और "search" शब्द, खोज के नतीजों में शामिल सभी दस्तावेज़ों के मुख्य हिस्से में दिखने चाहिए: उपयोगकर्ता का इनपुट: allintext:Google search क्वेरी शब्द: q=allintext%3AGoogle+search |
टाइटल सर्च, एक शब्द [intitle:] | |
---|---|
जानकारी |
ध्यान दें: दस्तावेज़ के टाइटल में एक से ज़्यादा शब्द शामिल किए जा सकते हैं. इसके लिए, आपको ऐसे हर शब्द के आगे
|
उदाहरण | इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के टाइटल में "Google" शब्द दिखना चाहिए. साथ ही, "खोज" शब्द इन दस्तावेज़ों के टाइटल, यूआरएल, लिंक या बॉडी टेक्स्ट में कहीं भी दिखना चाहिए: |
टाइटल सर्च, सभी शब्द [allintitle:] | |
---|---|
जानकारी |
ध्यान दें: किसी खोज क्वेरी की शुरुआत में
|
उदाहरण | इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के टाइटल में, "Google" और "खोज" शब्द दिखने चाहिए: |
URL खोज, एक शब्द [inurl:] | |
---|---|
जानकारी |
|
उदाहरण | इस उदाहरण से पता चलता है कि खोज के नतीजों में किसी भी दस्तावेज़ के यूआरएल में "Google" शब्द दिखना चाहिए. साथ ही, "खोज" शब्द उन दस्तावेज़ों के टाइटल, यूआरएल, लिंक या मुख्य हिस्से में कहीं भी दिखना चाहिए: |
यूआरएल सर्च, सभी शब्द [allinurl:] | |
---|---|
जानकारी |
|
उदाहरण | इस उदाहरण से पता चलता है कि खोज के नतीजों में मौजूद किसी भी दस्तावेज़ के यूआरएल में, "Google" और "खोज" शब्द दिखने चाहिए: |
वेब दस्तावेज़ की जानकारी [जानकारी:] | |
---|---|
जानकारी |
ध्यान दें: |
उदाहरण | उपयोगकर्ता का इनपुट: 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. किसी खास टाइप की इमेज दिखाता है. इन वैल्यू का इस्तेमाल किया जा सकता है: |
उदाहरण | q=google&as_filetype=png |
इमेज | |
---|---|
जानकारी | Optional. किसी खास साइज़ की इमेज दिखाता है, जहां साइज़ इनमें से कोई एक हो सकता है:
|
उदाहरण | q=google&as_filetype=png&imgsz=icon |
imgtype | |
---|---|
जानकारी | Optional. इस तरह की इमेज दिखाता है जो इनमें से कोई एक हो सकती है:
|
उदाहरण | q=google&as_filetype=png&imgtype=photo |
इमेजसी | |
---|---|
जानकारी | Optional. ब्लैक ऐंड व्हाइट, ग्रेस्केल या कलर इमेज दिखाता है:
|
उदाहरण | q=google&as_filetype=png&imgc=gray |
इमेज का रंग | |
---|---|
जानकारी | Optional. किसी खास मुख्य रंग की इमेज दिखाता है:
|
उदाहरण | q=google&as_filetype=png&imgcolor=yellow |
as_rights | |
---|---|
जानकारी | Optional. लाइसेंस देने के हिसाब से फ़िल्टर. ये वैल्यू इस्तेमाल की जा सकती हैं:
|
उदाहरण | 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 सेवा ऐसे नतीजे दिखा सकती है जिनमें दोनों वैरिएंट के पेज शामिल हों.
इस सुविधा का उपयोग करने के लिए:
- c2coff अनुरोध के पैरामीटर को 0 पर सेट करें
और - इनमें से कोई एक काम करें:
इस उदाहरण में वे क्वेरी पैरामीटर दिखाए गए हैं जिन्हें सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़, दोनों में खोज के नतीजों के लिए अनुरोध में शामिल किया जाएगा. (ध्यान दें कि उदाहरण में अतिरिक्त जानकारी शामिल नहीं है, जैसे कि क्लाइंट.)
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 एक्सएमएल के नतीजे DTD
- एक्सएमएल रिस्पॉन्स के बारे में जानकारी
- एक्सएमएल के दौरान, सामान्य और ऐडवांस खोज क्वेरी के नतीजे
- सामान्य/बेहतर खोज: क्वेरी का नमूना और एक्सएमएल के नतीजे
- सामान्य/बेहतर खोज: एक्सएमएल टैग
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, एक्सएमएल आउटपुट में ज़्यादा सुविधाएं जोड़ता है, तो इससे आपका ऐप्लिकेशन बिना बदलाव के काम करता रहेगा.
- एक्सएमएल टैग में वैल्यू के तौर पर शामिल करते समय, कुछ वर्ण एस्केप होने चाहिए. आपके एक्सएमएल प्रोसेसर को इन इकाइयों को वापस सही वर्णों में बदलना चाहिए. अगर आप इकाइयों को ठीक से नहीं बदलते हैं, तो ब्राउज़र, उदाहरण के लिए, & वर्ण को "&" के तौर पर रेंडर कर सकता है.
एक्सएमएल
स्टैंडर्ड में इन वर्णों को दस्तावेज़ में दिखाया जाता है. इन वर्णों को
नीचे दी गई टेबल में फिर से दिखाया गया है:
वर्ण एस्केप्ड फ़ॉर्म इकाई वर्ण कोड एंपरसैंड और & & सिंगल कोट ' ' ' डबल कोट " " " इससे ज़्यादा > > > इससे कम < < <
नियमित और बेहतर खोज क्वेरी के लिए एक्सएमएल के नतीजे
नियमित/बेहतर खोज: सैंपल क्वेरी और एक्सएमएल नतीजे
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 पर रीडायरेक्ट किया जा सकता है. |
|||||||||
एट्रिब्यूट |
|
|||||||||
उदाहरण | <C SZ="6k" CID="kvOXK_cYSSgJ" /> | |||||||||
इसका सबटैग | HAS | |||||||||
कॉन्टेंट फ़ॉर्मैट | खाली |
सी2सी | |
---|---|
परिभाषा | <C2C> टैग से पता चलता है कि नतीजा, पारंपरिक चाइनीज़ भाषा के पेज का है. यह टैग सिर्फ़ तब दिखता है, जब सिंप्लिफ़ाइड और ट्रेडिशनल चाइनीज़ सर्च चालू हो. इस सुविधा को चालू और बंद करने के बारे में ज़्यादा जानकारी के लिए, c2coff क्वेरी पैरामीटर की परिभाषा देखें. |
कॉन्टेंट फ़ॉर्मैट | टेक्स्ट |
संदर्भ | |
---|---|
परिभाषा | <Context> टैग, खोज के नतीजों के सेट से जुड़े बेहतर बनाने वाले लेबल की सूची को इकट्ठा करता है. |
उदाहरण | <Context> |
सबटैग | शीर्षक, मुखिका+ |
कॉन्टेंट फ़ॉर्मैट | कंटेनर |
CRAWLDATE | |
---|---|
परिभाषा | <CRAWLDATE> टैग उस तारीख की पहचान करता है जब पेज को पिछली बार क्रॉल किया गया था. |
उदाहरण | <CRAWLDATE>21 मई, 2005</CRAWLDATE> |
इसका सबटैग | R |
कॉन्टेंट फ़ॉर्मैट | टेक्स्ट |
डीआई | |
---|---|
परिभाषा | <DI> टैग, खोज के किसी एक नतीजे के लिए, Open डायरेक्ट्री प्रोजेक्ट (ODP) की कैटगरी की जानकारी इकट्ठा करता है. |
उदाहरण | <DI> |
सबटैग | DT?, DS? |
इसका सबटैग | HAS |
कॉन्टेंट फ़ॉर्मैट | खाली |
DS | |
---|---|
परिभाषा | <DS> टैग, ODP डायरेक्ट्री में किसी एक कैटगरी के लिए लिस्ट की गई खास जानकारी देता है. |
उदाहरण | <DS>अपने <b>soccer</b> को सीधे इंटरनेट पर फिर से शुरू करें</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 प्रोटोकॉल" का छोटा नाम है. |
||||||
एट्रिब्यूट |
|
||||||
उदाहरण | <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 ध्यान दें: <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 टैग होगा. |
||||||||||||
एट्रिब्यूट |
|
||||||||||||
उदाहरण | <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 के मुकाबले ज़्यादा पाबंदी वाली है. |
|||||||||
एट्रिब्यूट |
|
|||||||||
सबटैग | U, UE, T?, CRAWLDATE, S?, lang?, HAS | |||||||||
इसका सबटैग | रिज़ॉल्यूशन |
आरईएस | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
परिभाषा | <RES> टैग में, खोज के अलग-अलग नतीजों के सेट और उन नतीजों की जानकारी शामिल होती है. |
|||||||||
एट्रिब्यूट |
|
|||||||||
उदाहरण | <RES SN="1" EN="10"> | |||||||||
सबटैग | M, FI?, XT?, NB?, R* | |||||||||
इसका सबटैग | जीएसपी | |||||||||
कॉन्टेंट फ़ॉर्मैट | खाली |
S | |
---|---|
परिभाषा | <S> टैग में खोज के नतीजे के लिए एक छोटा हिस्सा होता है. इसमें, क्वेरी के लिए इस्तेमाल किए गए शब्दों को बोल्ड करके दिखाया जाता है. लाइन ब्रेक को टेक्स्ट में सही तरीके से रैप करने के लिए, हिस्से में शामिल किया जाता है. |
उदाहरण | <S>वॉशिंगटन (CNN) -- राष्ट्रपति <b>Bus's</b> न्यायिक चुनाव से पांच उम्मीदवारों को अंतिम मतदान के लिए आगे बढ़ने का विकल्प मिलेगा. <b>...<b>...</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 एट्रिब्यूट की वैल्यू, यूआरएल से एस्केप किया गया स्पेलिंग का सुझाव है. इसे क्वेरी के लिए इस्तेमाल किया जा सकता है. | ||||||
एट्रिब्यूट |
|
||||||
उदाहरण | <Suggestion q="soccer"><b><i>soccer</i></b></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><i>सलाह: ज़्यादातर ब्राउज़र के लिए, रिटर्न बटन दबाने पर, 'खोजें' बटन पर क्लिक करने जैसे नतीजे मिलते हैं.</i></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> टैग में, खोज के किसी एक नतीजे की जानकारी शामिल होती है. |
|||||||||
एट्रिब्यूट |
| |||||||||
इसका सबटैग | रिज़ॉल्यूशन |
रूस | |
---|---|
परिभाषा | <RU tag> टैग में, खोज के हर नतीजे की जानकारी शामिल होती है. |
इसका सबटैग | R |