Dokumentai

Vieno URL teikimas


Norėdami pateikti URL naudodami HTTP užklausą (pakeisti paieškos sistemos pateiktu URL), pateikite užklausą šiuo URL:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • „url-changed“ – tai jūsų svetainės URL, kuris buvo pridėtas, atnaujintas arba ištrintas. URL turi būti „URL-escaped“ ir užkoduotas. Be to, įsitikinkite, kad URL atitinka URI taikomą standartą RFC-3986.
  • „Your-key“ turi būti ne mažiau kaip 8 ir ne daugiau kaip 128 šešioliktainiai simboliai. Raktą gali sudaryti tik šie simboliai: mažosios raidės (a–z), didžiosios raidės (A–Z), skaičiai (0–9) ir brūkšneliai (-).

Pavyzdžiui, jei norite pranešti paieškos sistemoms, kad https://www.example.com/product.html atnaujintas, ir norite naudoti šį raktą , jūsų URL bus:

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

HTTP užklausą galite pateikti naudodami naršyklę, „wget“, „curl“ ar bet kurį kitą pasirinktą mechanizmą. Jei užklausa sėkminga, matysite HTTP 200 atsakymo kodą; jei gaunate kitokį atsakymą, patikrinkite, ar nepateikėte užklausų per dažnai, ar raktas ir URL galioja, ir iš naujo pateikite užklausą. HTTP 200 atsakymo kodas nurodo tik tai, kad paieškos sistema gavo jūsų URL.

URL rinkinio pateikimas


Norėdami pateikti URL rinkinį naudodami HTTP užklausą, pateikite „POST JSON“ užklausą paieškos sistemų pateiktam URL. Pakeiskite paieškos sistemos pagrindinio kompiuterio pavadinimu.

                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"
                      ]
                }
            

Maišydami „http“ ir „https“ URL, jei reikia, galite pateikti iki 10 000 URL viename skelbime.

HTTP užklausą galite pateikti naudodami „wget“, „curl“ ar kitą pasirinktą mechanizmą. Jei užklausa sėkminga, matysite HTTP 200 atsakymo kodą; jei gaunate kitokį atsakymą, turėtumėte patikrinti užklausą ir, jei viskas atrodo gerai, iš naujo ją pateikti. HTTP 200 atsakymo kodas nurodo tik tai, kad paieškos sistema gavo jūsų URL rinkinį.

Rekomenduojama automatizuoti URL pateikimą vos tik turinys pridedamas, atnaujinamas arba ištrinamas (iki tam tikros ribos); žr. naudotojų sukurto turinio gerąją patirtį dažniausiai užduodamuose klausimuose.

Nuosavybės tikrinimas naudojant raktą


Norėdami pateikti URL, turite „įrodyti“ pagrindinio kompiuterio, kuriam teikiami URL, nuosavybę pagrindiniame kompiuteryje priglobdami bent vieną tekstinį failą. Kai pateiksite URL paieškos sistemoms, paieškos moduliai aptiks rakto failą, kad patikrintų nuosavybę ir naudosis šiuo raktu, kol jį pakeisite. Raktą ir failo rakto vietą turite žinoti tik jūs ir paieškos sistemos.

Siūlome du būdus, kaip patikrinti nuosavybę.

1 būdas
Tekstinio rakto failo priegloba pagrindinio kompiuterio šakniniame kataloge.

Turite priglobti UTF-8 užkoduotą tekstinį rakto failą {your-key}.txt svetainės šakniniame kataloge.

Pavyzdžiui, ankstesniuose pavyzdžiuose UTF-8 rakto failą reikėtų priglobti adresu https://www.example.com/.txt, o šiame faile turi būti raktas

2 būdas
Tekstinio rakto failo priegloba pagrindiniame kompiuteryje.

Taip pat galite priglobti vienu UTF-8 užkoduotu tekstiniu rakto failu daugiau kitose to paties pagrindinio kompiuterio vietose ir turite nurodyti paieškos sistemoms šio tekstinio rakto failo vietą kiekviename „IndexNow“ pranešime, naudodami kintamąjį „keyLocation“.

Jei pateiksite URL, nurodykite rakto failo vietą kaip „keyLocation“ URL parametro reikšmę.

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

Jei pateiksite URL rinkinį, nurodykite rakto failo vietą kaip „keyLocation“ JSON turinio kintamąjį.

                    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"
                          ]
                    }
                

Naudojant 2 būdą, rakto failo vieta nustato URL, kuriuos galima įtraukti į šį raktą, rinkinį. Pagrindiniame faile, esančiame http://example.com/catalog/key12457EDd.txt, gali būti bet kokie URL, pradedant nuo http://example.com/catalog/, bet negali būti URL, kurie prasideda http://example.com/help/.

URL, kurie nelaikomi galiojančiais http://example.com/catalog/sitemap.xml:

URL, kurie 2 atveju nelaikomi galiojančiais, gali būti neįtraukti į indeksavimą. Primygtinai rekomenduojama naudoti 1 būdą ir failo raktą laikyti žiniatinklio serverio šakniniame kataloge.

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 or be closely linked to the search market and make a significant contribution to the number of url submissions. Learn more