Dokumentace
Odeslání jedné adresy URL
Chcete-li adresu URL odeslat pomocí požadavku HTTP (
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íč
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.
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í.
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/
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.
Response format
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