दस्तावेज़ीकरण

एक URL सबमिट करना


HTTP अनुरोध का उपयोग करके URL सबमिट करने के लिए ( को खोज इंजन द्वारा प्रदान किए गए URL से बदलें), अपना अनुरोध नीचे दिए गए URL पर जारी करें:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • परिवर्तित किया गया url, आपकी वेबसाइट का URL है, जिसे जोड़ा, अद्यतन किया गया या हटाया गया है. URL, एस्केप किया गया और एन्कोड किया गया URL होना चाहिए और कृपया सुनिश्चित करें कि आपके URL, URI के RFC-3986 मानक का पालन करते हैं.
  • आपकी कुंजी में न्यूनतम 8 और अधिकतम 128 हेक्साडेसिमल वर्ण होने चाहिए. कुंजी में केवल निम्नलिखित वर्ण हो सकते हैं: लोअरकेस वर्ण (a-z), अपरकेस वर्ण (A-Z), संख्याएँ (0-9) और डैशेस (-).

उदाहरण के लिए, अगर आप खोज इंजन को यह सूचित करना चाहते हैं कि https://www.example.com/product.html अद्यतित कर दिया गया है और आप इस कुंजी का उपयोग करना चाहते हैं, तो आपका URL यह होगा:

                https://<searchengine>/indexnow?url=https://www.example.com/product.html&key=
            

आप अपना ब्राउज़र, wget, curl, या अपनी पसंद के किसी दूसरे मेकेनिज़्म का उपयोग करके HTTP अनुरोध जारी कर सकते हैं. सफल अनुरोध HTTP 200 प्रतिसाद कोड प्रदर्शित करेगा; अगर आपको कोई और प्रतिसाद प्राप्त होता है, तो सत्यापित करें कि आपने उसे बहुत बार सबमिट नहीं किया है, यह कि कुंजी और URL मान्य हैं और अनुरोध को पुनः सबमिट करें. HTTP 200 प्रतिसाद कोड सिर्फ़ यही संकेत देता है कि खोज इंजन को आपका URL मिल गया है.

URL का सेट सबमिट करना


HTTP अनुरोध का उपयोग करके URL का सेट सबमिट करने के लिए खोज इंजन द्वारा प्रदान किए गए URL पर अपना POST JSON अनुरोध जारी करें. को खोज इंजन के होस्ट नाम द्वारा बदलें.

                POST /indexnow HTTP/1.1
                Content-Type: application/json; charset=utf-8
                Host: <searchengine>
                {
                  "host": "www.example.com",
                  "key": "",
                  "urlList": [
                      "https://www.example.com/url1",
                      "https://www.example.com/folder/url2",
                      "https://www.example.com/url3"
                      ]
                }
            

आवश्यकता पड़ने पर आप http और https को संयोजित करके प्रति पोस्ट अधिकतम 10,000 URL सबमिट कर सकते हैं.

आप wget, curl, या अपनी पसंद के किसी अन्य मेकेनिज़्म का उपयोग करके HTTP अनुरोध जारी कर सकते हैं. सफल अनुरोध HTTP 200 प्रतिसाद कोड प्रदर्शित करेगा; अगर आपको कोई और प्रतिसाद प्राप्त होता है, तो आपको अपने अनुरोध को सत्यापित करना चाहिए और अगर सब कुछ ठीक दिखाई देता है, तो अपने अनुरोध को पुनः सबमिट करें. HTTP 200 प्रतिसाद कोड सिर्फ़ यही संकेत देता है कि खोज इंजन को आपके URL का सेट मिल गया है.

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

कुंजी के माध्यम से स्वामित्व का सत्यापन करना


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

हम स्वामित्व का सत्यापन करने के दो तरीके प्रस्तुत करते हैं.

विकल्प 1
आपके होस्ट की मूल डायरेक्टरी में टेक्स्ट कुंजी फ़ाइल को होस्ट करना.

आपको अपनी वेबसाइट की मूल डायरेक्टरी में फ़ाइल में कुंजी को लिस्ट में जोड़कर UTF-8 एन्कोड की गई टेक्स्ट कुंजी फ़ाइल {your-key}.txt होस्ट करनी होगी.

उदाहरण के लिए पिछले उदाहरणों के लिए, आपको अपनी UTF-8 कुंजी फ़ाइल https://www.example.com/.txt पर होस्ट करनी होगी और इस फ़ाइल में कुंजी शामिल होनी आवश्यक है

विकल्प 2
टेक्स्ट कुंजी फ़ाइल को आपके होस्ट के अंतर्गत होस्ट करना.

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

अगर आप URL सबमिट करते हैं, तो कुंजी फ़ाइल का स्थान keyLocation चर के रूप में निर्दिष्ट करें.

                    https://<searchengine>/indexnow?url=http://www.example.com/product.html&key=&keyLocation=http://www.example.com/myIndexNowKey63638.txt
                

अगर आप URL का सेट सबमिट करते हैं, तो JSON सामग्री में कुंजी फ़ाइल का स्थान keyLocation चर के रूप में निर्दिष्ट करें.

                    POST /indexnow HTTP/1.1
                    Content-Type: application/json; charset=utf-8
                    Host: <searchengine>
                    {
                      "host": "www.example.com",
                      "key": "",
                      "keyLocation": "https://www.example.com/myIndexNowKey63638.txt",
                      "urlList": [
                          "https://www.example.com/url1",
                          "https://www.example.com/folder/url2",
                          "https://www.example.com/url3"
                          ]
                    }
                

इस विकल्प 2 में कुंजी फ़ाइल का स्थान, URL का वह सेट निर्धारित करता है जिसे इस कुंजी के साथ शामिल किया जा सकता है. http://example.com/catalog/key12457EDd.txt पर स्थित कुंजी फ़ाइल में http://example.com/catalog/ से शुरू होने वाले URL शामिल हो सकते हैं, लेकिन http://example.com/help/ से शुरू होने वाले URL शामिल नहीं हो सकते हैं.

उन URL में, जिन्हें http://example.com/catalog/sitemap.xml में मान्य नहीं माना जाता है, में निम्नलिखित शामिल हैं:

उन URL पर, जिन्हें विकल्प 2 में मान्य नहीं माना जाता है, इंडेक्सिंग के लिए विचार नहीं किया जाएगा. यह पुरज़ोर अनुशंसा की जाती है कि आप विकल्प 1 का उपयोग करें और अपनी फ़ाइल कुंजी को अपने वेब सर्वर की मूल डायरेक्टरी पर रखें.

Response format


HTTP Code
Response
Reasons
200
OK
URL submitted successfully
202
Accepted
URL received. IndexNow key validation pending.
400
Bad request
Invalid format
403
Forbidden
In case of key not valid (e.g. key not found, file found but key not in the file)
422
Unprocessable Entity
In case of URLs which don’t belong to the host or the key is not matching the schema in the protocol
429
Too Many Requests
Too Many Requests (potential Spam)

Requirement for search engines


Search Engines adopting the IndexNow protocol agree that submitted URLs will be automatically shared with all other participating Search Engines. To participate, search engines must have a noticeable presence in at least one market.