Dokumentace

Odeslání jedné adresy URL


Chcete-li adresu URL odeslat pomocí požadavku HTTP ( nahraďte adresou URL uvedenou ve vyhledávači), vydejte svůj požadavek na následující adresu URL:

                https://<searchengine>/indexnow?url=url-changed&key=your-key
            
  • url-changed je adresa URL vaší webové stránky, která byla přidána, aktualizována nebo odstraněna. Adresa URL musí být uvedena znakem „escape“ a kódována. Ujistěte se, že vaše adresy URL splňují standard RFC-3986 pro identifikátory URI.
  • Your-key by měl obsahovat minimálně 8 a maximálně 128 šestnáctkových znaků. Klíč může obsahovat jen následující znaky: malá písmena (a–z), velká písmena (A–Z), číslice (0–9) a pomlčky (-).

Například pokud chcete vyhledávače informovat, že stránka https://www.example.com/product.html byla aktualizována a chcete použít tento klíč , vaše adresa URL bude následující:

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

Požadavek HTTP můžete vydat pomocí vašeho prohlížeče, wget, curl nebo jakéhokoli jiného mechanismu, který si vyberete. Úspěšný požadavek vrátí kód odpovědi HTTP 200. Pokud obdržíte jinou odpověď, ověřte, že neodesíláte požadavky příliš často a že klíč a adresa URL jsou platné, a poté požadavek odešlete znovu. Kód odpovědi HTTP 200 pouze značí, že vyhledávač obdržel vaši adresu URL.

Odeslání sady adres URL


Chcete-li odeslat sadu adres URL pomocí požadavku HTTP, vydejte požadavek POST JSON na adresu URL uvedenou ve vyhledávačích. nahraďte názvem hostitele vyhledávače.

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

V jednom příspěvku můžete odeslat až 10 000 adres URL a v případě potřeby můžete kombinovat adresy URL http a https.

Požadavek HTTP můžete vydat pomocí wget, curl nebo jiného mechanismu, který si vyberete. Úspěšný požadavek vrátí kód odpovědi HTTP 200. Pokud jste obdrželi jinou odpověď, měli byste požadavek ověřit. Pokud všechno vypadá v pořádku, odešlete požadavek znovu. Kód odpovědi HTTP 200 pouze značí, že vyhledávač obdržel vaši sadu adres URL.

Doporučujeme zautomatizovat odesílání adres URL ihned, když jsou přidány, aktualizovány nebo odstraněny, až do určitého limitu. Projděte si osvědčené postupy týkající se uživatelem generovaného obsahu v Častých dotazech.

Ověření vlastnictví prostřednictvím klíče


Chcete-li odeslat adresy URL, musíte „prokázat“ vlastnictví hostitele, pro kterého adresy URL odesíláte, a to hostováním alespoň jednoho textového souboru na daném hostiteli. Po odeslání adres URL do vyhledávačů vyhledávače projdou soubor klíče, aby ověřily vlastnictví. Klíč bude používán, dokud ho nezměníte. Klíč a umístění souboru klíče byste měli znát pouze vy a vyhledávače.

Poskytujeme dva způsoby ověření vlastnictví.

Možnost 1
Hostování textového souboru klíče v kořenovém adresáři hostitele

Musíte hostovat textový soubor klíče s kódováním UTF-8 {your-key}.txt, který obsahuje klíč v souboru v kořenovém adresáři vaší webové stránky.

Například pro předchozí příklady budete muset hostovat soubor klíče UTF-8 na adrese https://www.example.com/.txt a tento soubor musí obsahovat klíč .

Možnost 2
Hostování textového souboru klíče na hostiteli

Můžete hostovat jeden až několik textových souborů klíče s kódováním UTF-8 v různých umístěních na stejném hostiteli a vyhledávačům musíte sdělit umístění tohoto textového souboru klíče v každém oznámení IndexNow, a to tak, že umístění zadáte pomocí proměnné keyLocation.

Pokud odesíláte jednu adresu URL, zadejte umístění souboru klíče jako hodnotu parametru keyLocation adres URL.

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

Pokud odesíláte sadu adres URL, zadejte umístění souboru klíče jako proměnnou keyLocation v obsahu JSON.

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

V této druhé možnosti umístění souboru klíče určuje sadu adres URL, které lze s tímto klíčem zahrnout. Soubor klíče umístění na adrese http://example.com/catalog/key12457EDd.txt může zahrnovat jakékoli adresy URL začínající na http://example.com/catalog/, ale nemůže zahrnovat adresy URL začínající na http://example.com/help/.

Adresy URL, které nejsou v souboru http://example.com/catalog/sitemap.xml považovány za platné:

Adresy URL, které nejsou považovány za platné ve druhé možnosti, nemusí být vhodné pro indexování. Důrazně doporučujeme, abyste použili první možnost a umístili soubor klíče do kořenového adresáře vašeho webového serveru.

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.