Indexing API

Definice Indexing API

Indexing API je programový nástroj vyvinutý společností Google, který umožňuje vlastníkům webových stránek přímo informovat Google Search o přidání, aktualizaci nebo odstranění URL adres z jejich webů. Místo čekání, až roboti Googlu objeví nový obsah prostřednictvím tradičních metod procházení, Indexing API umožňuje odesílat oznámení v reálném čase do indexační infrastruktury Googlu, což spouští okamžité naplánování procházení zadaných URL adres. Tento mechanismus přímého odesílání představuje zásadní posun od pasivního objevování k aktivní komunikaci s vyhledávači, což výrazně zkracuje dobu mezi publikováním obsahu a jeho indexováním ve vyhledávači. API pracuje prostřednictvím HTTP POST požadavků na endpoint Googlu na adrese https://indexing.googleapis.com/v3/urlNotifications:publish, přičemž přijímá JSON payloady, které specifikují URL adresu a typ oznámení.

Historický kontext a vývoj

Indexing API bylo oficiálně představeno společností Google v červnu 2018, původně navrženo k řešení jedinečných problémů s indexováním, kterým čelily webové stránky s pracovními nabídkami a stránky s živým vysíláním událostí. Tyto typy obsahu vyžadují časté aktualizace a časově citlivé indexování, aby byla zachována přesnost ve výsledcích vyhledávání – pracovní nabídka, která zůstává indexována i po obsazení pozice, vytváří špatnou uživatelskou zkušenost, a živá vysílání potřebují rychlé indexování, aby se objevila ve výsledcích vyhledávání v reálném čase. Před zavedením API se vlastníci webů spoléhali výhradně na XML sitemapy, interní propojovací struktury a organický crawl budget Googlu, aby jejich obsah byl objeven. API představovalo přiznání Googlu, že určité kategorie obsahu vyžadují rychlejší a předvídatelnější mechanismy indexování. Během posledních šesti let došlo k výraznému nárůstu adopce, přičemž hlavní systémy pro správu obsahu a hostingové platformy integrovaly podporu Indexing API přímo do svých platforem. Průmyslová data ukazují, že přibližně 80 % podniků nyní používá nějakou formu API řízené správy obsahu, přičemž Indexing API se stalo standardní součástí technických SEO strategií pro vydavatele časově citlivého obsahu.

Ready to Monitor Your AI Visibility?

Track how AI chatbots mention your brand across ChatGPT, Perplexity, and other platforms.

Začít Kontakt

Jak Indexing API funguje: Technická implementace

Indexing API funguje na jednoduchém, ale výkonném mechanismu: odešlete HTTP POST požadavek obsahující JSON payload na určený endpoint Googlu. Tělo JSON musí obsahovat dvě povinná pole: plně kvalifikovanou URL adresu, o které chcete Google informovat, a typ oznámení (URL_UPDATED nebo URL_DELETED). Když Google obdrží váš požadavek s kódem odpovědi HTTP 200, znamená to, že vaše oznámení bylo úspěšně přijato a Google naplánuje procházení této URL adresy. API podporuje dávkové zpracování, které umožňuje kombinovat až 100 jednotlivých oznámení o URL do jednoho HTTP požadavku, což snižuje režii a zvyšuje efektivitu pro weby s velkým objemem aktualizací. Každý dávkový požadavek může obsahovat kombinaci oznámení o aktualizaci a odstranění, což jej činí flexibilním pro komplexní scénáře správy obsahu. Indexing API také poskytuje metadata endpoint (/urlNotifications/metadata), který umožňuje zkontrolovat stav dříve odeslaných oznámení a zobrazuje časové razítko posledních oznámení o aktualizaci a odstranění, která Google pro danou URL adresu obdržel.

Kvóta a omezení: Porozumění API omezením

Indexing API pracuje v rámci specifických kvótových omezení navržených k zabránění zneužití a zajištění spravedlivého přidělování zdrojů všem uživatelům. Výchozí kvóta poskytuje 200 publikačních požadavků denně na projekt, což zahrnuje oba typy oznámení URL_UPDATED i URL_DELETED dohromady. To znamená, že pokud odešlete 150 oznámení o aktualizaci, zbývá vám již pouze 50 oznámení o odstranění na daný den. Dále je zde kvóta 180 požadavků pouze pro čtení za minutu pro dotazy na metadata a limit 380 požadavků za minutu pro všechny endpointy dohromady. Tyto kvóty se resetují o půlnoci pacifického času, což znamená, že nová dostupnost kvóty může nabýt účinnosti až za 24 hodin. Pro weby vyžadující vyšší kvóty Google umožňuje požádat o schválení prostřednictvím formálního aplikačního procesu, přičemž zvýšení kvót je určeno na základě kvality dokumentů, legitimních případů použití a souladu s pravidly Googlu proti spamu. Důležité je, že Indexing API je zcela zdarma – Google neúčtuje žádné poplatky bez ohledu na úroveň kvóty nebo objem požadavků.

Stay Updated on AI Visibility Trends

Get the latest insights on AI mentions, brand monitoring, and optimization strategies.

Email address

Subscribe

Srovnání: Indexing API vs. související metody indexování

Technické požadavky a autentizace

Pro použití Indexing API musíte nastavit řádnou autentizaci a autorizaci prostřednictvím frameworku OAuth 2.0 od Googlu. Nejprve potřebujete projekt Google Cloud s povoleným Indexing API prostřednictvím Google Cloud Console. Dále musíte v rámci tohoto projektu vytvořit servisní účet (Service Account) a vygenerovat JSON klíčový soubor obsahující autentizační údaje. Tento servisní účet musí být poté přidán jako vlastník (Owner) k vaší webové vlastnosti v Google Search Console, čímž se vytvoří vztah důvěry mezi vaším servisním účtem a vaší doménou. Proces autentizace vyžaduje získání OAuth 2.0 přístupového tokenu pomocí přihlašovacích údajů vašeho servisního účtu, který poté zahrnete do hlavičky Authorization vašich API požadavků. Všechny požadavky musí používat "application/json" jako hlavičku Content-Type. Tento několika-krokový autentizační proces, i když je složitější než jednoduché odeslání API klíče, poskytuje robustní zabezpečení tím, že zajišťuje, že pouze autorizovaní zástupci domény mohou odesílat požadavky na indexování pro danou doménu.

Praktická implementace: Postup krok za krokem

Implementace Indexing API zahrnuje několik po sobě jdoucích kroků, které musí být provedeny v daném pořadí. Nejprve přejděte do konzole Google Cloud Platform a vytvořte nový projekt určený speciálně pro operace indexování. Za druhé povolte Indexing API pro tento projekt prostřednictvím knihovny API. Za třetí vytvořte servisní účet (Service Account) a stáhněte jeho JSON soubor s přihlašovacími údaji – tento soubor obsahuje vaše autentizační tajemství a musí být bezpečně uchováván. Za čtvrté přidejte e-mailovou adresu servisního účtu jako vlastníka (Owner) v nastavení vlastnosti vašeho webu v Google Search Console. Za páté nakonfigurujte backend vašeho webu nebo použijte plugin (např. Rank Math Instant Indexing) k automatickému odesílání oznámení při publikování, aktualizaci nebo odstranění obsahu. Nakonec otestujte integraci odesláním vzorové URL adresy a ověřením, že Google odpovídá stavovým kódem HTTP 200. Po zprovoznění může systém automaticky informovat Google o změnách obsahu bez manuálního zásahu, čímž vytváří bezproblémový pracovní postup indexování.

Typy obsahu a požadavky na strukturovaná data

Indexing API oficiálně podporuje pouze dva typy obsahu: JobPosting a BroadcastEvent (vložený do VideoObject). U stránek s JobPosting musí vaše HTML obsahovat strukturovaná data pomocí schématu JobPosting ze schema.org s povinnými poli jako název pozice, název společnosti, místo pracovní pozice a typ pracovního poměru. U stránek s BroadcastEvent musí být strukturovaná data vložena do schématu VideoObject s uvedením času začátku a konce vysílání. Oficiální dokumentace Googlu zdůrazňuje, že stránky odeslané prostřednictvím API musí obsahovat platná, správně formátovaná strukturovaná data pro jeden z těchto dvou typů. Průmyslové testování však ukázalo, že roboti Googlu zpracují URL adresy odeslané prostřednictvím API bez ohledu na přítomnost strukturovaných dat, ačkoli oficiální shoda vyžaduje správné značení. Tento rozpor mezi oficiálními požadavky a pozorovaným chováním vedl mnoho SEO profesionálů k širšímu používání API, ačkoli Google doporučuje důsledné dodržování oficiálních pokynů, aby se předešlo možnému odebrání přístupu.

Dopad na viditelnost ve vyhledávání a rychlost rankování

Indexing API dramaticky zkracuje dobu mezi publikováním obsahu a jeho viditelností ve vyhledávačích. Tradiční indexování prostřednictvím procházení a objevování pomocí sitemap může trvat od hodin až po týdny, v závislosti na crawl budgetu a autoritě vašeho webu. S Indexing API jsou stránky typicky procházeny během minut po odeslání oznámení. Průmyslové případové studie ukazují, že zpravodajské weby používající Indexing API dosahují indexování během 30 minut až 2 hodin, ve srovnání s 15–48 hodinami u přístupů pouze se sitemapami. Tato rychlostní výhoda je obzvláště cenná pro časově citlivý obsah, jako jsou mimořádné zprávy, uvedení produktů na trh, pracovní nabídky a časově omezené nabídky. Rychlejší indexování se přímo promítá do konkurenční výhody – váš obsah může rankovat a získávat návštěvnost z vyhledávání dříve, než je podobný obsah konkurence vůbec objeven. Pro e-commerce weby znamená rychlé indexování nových produktových stránek rychlejší viditelnost ve výsledcích vyhledávání produktů. Pro pracovní portály zajišťuje okamžité indexování, že se pracovní nabídky objeví ve výsledcích Google Jobs, zatímco jsou stále aktivně nabízeny.

Integrace se systémy pro správu obsahu a platformami

Většina moderních systémů pro správu obsahu nyní nabízí vestavěnou nebo pluginovou podporu pro Indexing API. Uživatelé WordPressu mohou využít pluginy jako Rank Math Instant Indexing nebo samostatné pluginy pro rychlé indexování, které automaticky odesílají URL adresy do API při publikování nebo aktualizaci příspěvků. Majitelé Shopify obchodů mohou používat aplikace třetích stran nebo vlastní skripty k integraci odesílání API s aktualizacemi produktů. Vývojáři na Webflow mohou implementovat API prostřednictvím vlastního kódu nebo automatizačních platforem jako Zapier. WooCommerce obchody mohou používat SEO pluginy podporující automatické odesílání do API. Pro vlastní weby a podnikové platformy mohou vývojáři integrovat API přímo do backendového publikačního workflow, čímž zajistí, že každá aktualizace obsahu automaticky spustí oznámení o indexování. Tato rozšířená integrace znamená, že mnoho vlastníků webů těží z Indexing API aniž by jej explicitně konfigurovalo – jejich platforma se o technickou implementaci stará automaticky.

Klíčové implementační aspekty a osvědčené postupy

• Odesílejte pouze kvalitní, originální obsah prostřednictvím API, abyste udrželi svou kvótu a předešli možným omezením přístupu
• Používejte API selektivně pro časově citlivé nebo vysoce hodnotné stránky, místo odesílání každé stránky na vašem webu
• Kombinujte API s XML sitemapami pro komplexní pokrytí – sitemapy poskytují kompletní inventář URL, zatímco API urychluje objevování aktualizací
• Udržujte správná strukturovaná data na stránkách, které odesíláte, zejména pro typy obsahu JobPosting a BroadcastEvent
• Sledujte využití kvóty prostřednictvím Google Cloud Console, abyste nepřekročili denní limity
• Implementujte ošetření chyb ve své integraci pro elegantní zvládání selhání API nebo vyčerpání kvóty
• Důkladně testujte před nasazením do produkce pomocí API Console k ověření úspěšného odeslání
• Uchovávejte přihlašovací údaje svého servisního účtu v bezpečí a pravidelně rotujte JSON klíče pro dodržení bezpečnostních osvědčených postupů
• Zdokumentujte svou API implementaci pro svůj tým, aby byla zajištěna konzistentní správa a údržba
• Sledujte výkonnost indexování porovnáním dat procházení před a po implementaci API pro měření dopadu

Auditování funkčnosti vaší implementace Indexing API

Ověření, že API funguje správně, vyžaduje kontrolu více než jen toho, zda požadavky vracejí stav 200. Krok 1: Potvrďte, že autentizace je skutečně platná, nejen nakonfigurovaná. Zkontrolujte, zda je servisní účet uveden jako vlastník (Owner) (nikoli pouze uživatel) v Google Search Console pro ověřenou vlastnost – servisní účet s nedostatečnými oprávněními se může úspěšně autentizovat, ale tiše selhat při registraci oznámení. Krok 2: Zkontrolujte spotřebu kvóty oproti skutečnému objemu odesílání. Získejte data o využití z Google Cloud Console a porovnejte je s počtem URL adres, které podle vás denně odesíláte – neshoda indikuje buď duplicitní odesílání, nebo nefunkční integraci, která u některých stránek tiše selhává. Krok 3: Dotazujte se na metadata endpoint pro vzorek odeslaných URL adres. Endpoint /urlNotifications/metadata vrací časové razítko, kdy Google naposledy obdržel oznámení pro danou URL adresu – pokud toto časové razítko neodpovídá vašemu nedávnému odeslání, oznámení se k Googlu nedostává, přestože váš systém hlásí úspěch. Krok 4: Ověřte způsobilost typu obsahu. Vzhledem k tomu, že oficiální podpora API je omezena na strukturovaná data JobPosting a BroadcastEvent, potvrďte, že stránky, které odesíláte, skutečně obsahují správné schema markup – použijte Google Rich Results Test k ověření značení nezávisle na odeslání API. Krok 5: Porovnejte skutečnou rychlost indexování před a po implementaci. Zkontrolujte data procházení v nástroji URL Inspection Tool v Search Console pro nedávno odeslané stránky oproti základní sadě stránek, které nebyly odeslány prostřednictvím API – pokud není v době do procházení žádný smysluplný rozdíl, integrace může být chybně nakonfigurována, i když hlásí úspěch.

+++