Indexing API

Definizione di Indexing API

L’Indexing API è uno strumento programmatico sviluppato da Google che consente ai proprietari di siti web di notificare direttamente a Google Search quando gli URL vengono aggiunti, aggiornati o rimossi dai loro siti. Invece di attendere che i crawler di Google scoprano nuovi contenuti attraverso metodi di scansione tradizionali, l’Indexing API ti permette di inviare notifiche in tempo reale all’infrastruttura di indicizzazione di Google, attivando una pianificazione immediata della scansione per gli URL specificati. Questo meccanismo di invio diretto rappresenta un cambiamento fondamentale dalla scoperta passiva alla comunicazione attiva con i motori di ricerca, riducendo significativamente il tempo tra la pubblicazione dei contenuti e l’indicizzazione nei motori di ricerca. L’API opera tramite richieste HTTP POST all’endpoint di Google all’indirizzo https://indexing.googleapis.com/v3/urlNotifications:publish, accettando payload JSON che specificano l’URL e il tipo di notifica.

Contesto Storico ed Evoluzione

L’Indexing API è stato introdotto ufficialmente da Google a giugno 2018, inizialmente progettato per affrontare le sfide di indicizzazione uniche affrontate dai siti web di annunci di lavoro e dalle pagine di eventi in live streaming. Questi tipi di contenuto richiedono aggiornamenti frequenti e un’indicizzazione sensibile al fattore tempo per mantenere l’accuratezza nei risultati di ricerca — un annuncio di lavoro che rimane indicizzato dopo essere stato coperto crea una cattiva esperienza utente, e gli eventi in live streaming necessitano di un’indicizzazione rapida per apparire nei risultati di ricerca in tempo reale. Prima dell’introduzione dell’API, i proprietari di siti web facevano completamente affidamento sugli XML sitemap, sulle strutture di collegamento interno e sul crawl budget organico di Google per far scoprire i propri contenuti. L’API ha rappresentato il riconoscimento da parte di Google che determinate categorie di contenuti necessitavano di meccanismi di indicizzazione più rapidi e prevedibili. Negli ultimi sei anni, l’adozione è cresciuta in modo significativo, con i principali sistemi di gestione dei contenuti e piattaforme di hosting che hanno integrato il supporto dell’Indexing API direttamente nelle loro piattaforme. I dati di settore mostrano che circa l'80% delle imprese ora utilizza una qualche forma di gestione dei contenuti basata su API, con l’Indexing API che è diventato un componente standard delle strategie SEO tecniche per gli editori di contenuti sensibili al fattore tempo.

Ready to Monitor Your AI Visibility?

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

Inizia ora Contatto

Come Funziona l’Indexing API: Implementazione Tecnica

L’Indexing API opera attraverso un meccanismo semplice ma potente: invii una richiesta HTTP POST contenente un payload JSON all’endpoint designato di Google. Il corpo JSON deve includere due campi obbligatori: l’URL completo di cui vuoi notificare Google e il tipo di notifica (URL_UPDATED o URL_DELETED). Quando Google riceve la tua richiesta con un codice di risposta HTTP 200, significa che la tua notifica è stata ricevuta con successo e Google pianificherà una scansione di quell’URL. L’API supporta l’elaborazione batch, consentendoti di combinare fino a 100 notifiche URL individuali in un’unica richiesta HTTP, riducendo il sovraccarico e migliorando l’efficienza per i siti con aggiornamenti ad alto volume. Ogni richiesta batch può contenere un mix di notifiche di aggiornamento e cancellazione, rendendola flessibile per scenari complessi di gestione dei contenuti. L’Indexing API fornisce anche un endpoint per i metadati (/urlNotifications/metadata) che ti consente di verificare lo stato delle notifiche inviate in precedenza, mostrando il timestamp dell’ultima notifica di aggiornamento e cancellazione che Google ha ricevuto per un determinato URL.

Quota e Limitazioni: Comprendere i Vincoli dell’API

L’Indexing API opera sotto specifici limiti di quota progettati per prevenire abusi e garantire un’equa allocazione delle risorse tra tutti gli utenti. La quota predefinita prevede 200 richieste di pubblicazione al giorno per progetto, che include sia le notifiche URL_UPDATED che URL_DELETED combinate. Ciò significa che se invii 150 notifiche di aggiornamento, ti rimangono solo 50 notifiche di cancellazione per quel giorno. Inoltre, c’è una quota di 180 richieste in sola lettura al minuto per le query sui metadati e un limite di 380 richieste al minuto su tutti gli endpoint. Queste quote vengono reimpostate a mezzanotte ora del Pacifico, quindi la nuova disponibilità di quota può richiedere fino a 24 ore per diventare effettiva. Per i siti web che necessitano di quote più elevate, Google consente di richiedere l’approvazione tramite un processo di candidatura formale, con aumenti di quota determinati in base alla qualità dei documenti, ai casi d’uso legittimi e alla conformità con le policy anti-spam di Google. È importante notare che l’Indexing API è completamente gratuito — Google non addebita alcun costo indipendentemente dal livello di quota o dal volume di richieste.

Stay Updated on AI Visibility Trends

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

Email address

Subscribe

Confronto: Indexing API vs. Metodi di Indicizzazione Correlati

Requisiti Tecnici e Autenticazione

Per utilizzare l’Indexing API, devi stabilire un’autenticazione e un’autorizzazione adeguate tramite il framework OAuth 2.0 di Google. Innanzitutto, hai bisogno di un Progetto Google Cloud con l’Indexing API abilitato tramite la Google Cloud Console. Successivamente, devi creare un Account di Servizio all’interno di quel progetto e generare un file di chiave JSON contenente le credenziali di autenticazione. Questo account di servizio deve poi essere aggiunto come Proprietario alla proprietà del tuo sito web in Google Search Console, stabilendo la relazione di fiducia tra il tuo account di servizio e il tuo dominio. Il processo di autenticazione richiede l’ottenimento di un token di accesso OAuth 2.0 utilizzando le credenziali del tuo account di servizio, che includerai poi nell’intestazione Authorization delle tue richieste API. Tutte le richieste devono utilizzare "application/json" come intestazione Content-Type. Questo processo di autenticazione a più fasi, sebbene più complesso del semplice invio di una chiave API, fornisce una sicurezza robusta garantendo che solo i rappresentanti autorizzati di un dominio possano inviare richieste di indicizzazione per quel dominio.

Implementazione Pratica: Flusso di Lavoro Passo dopo Passo

L’implementazione dell’Indexing API comporta diversi passaggi sequenziali che devono essere completati in ordine. Innanzitutto, accedi alla console di Google Cloud Platform e crea un nuovo progetto specificamente dedicato alle operazioni di indicizzazione. In secondo luogo, abilita l’Indexing API per quel progetto tramite la libreria API. Terzo, crea un Account di Servizio e scarica il suo file di credenziali JSON — questo file contiene i segreti di autenticazione e deve essere mantenuto al sicuro. Quarto, aggiungi l’indirizzo email dell’account di servizio come Proprietario nelle impostazioni della proprietà del tuo sito web in Google Search Console. Quinto, configura il backend del tuo sito web o utilizza un plugin (come Rank Math Instant Indexing) per inviare automaticamente notifiche ogni volta che i contenuti vengono pubblicati, aggiornati o eliminati. Infine, testa l’integrazione inviando un URL di esempio e verificando che Google risponda con un codice di stato HTTP 200. Una volta operativo, il sistema può notificare automaticamente a Google le modifiche ai contenuti senza intervento manuale, creando un flusso di lavoro di indicizzazione senza soluzione di continuità.

Tipi di Contenuto e Requisiti dei Dati Strutturati

L’Indexing API supporta ufficialmente solo due tipi di contenuto: JobPosting e BroadcastEvent (incorporato all’interno di VideoObject). Per le pagine JobPosting, il tuo HTML deve includere dati strutturati utilizzando lo schema JobPosting di schema.org, contenente campi essenziali come titolo del lavoro, nome dell’azienda, luogo di lavoro e tipo di impiego. Per le pagine BroadcastEvent, i dati strutturati devono essere incorporati all’interno di uno schema VideoObject, specificando gli orari di inizio e fine della trasmissione. La documentazione ufficiale di Google sottolinea che le pagine inviate tramite l’API devono contenere dati strutturati validi e correttamente formattati per uno di questi due tipi. Tuttavia, test di settore hanno dimostrato che i crawler di Google elaboreranno gli URL inviati tramite l’API indipendentemente dalla presenza di dati strutturati, sebbene la conformità ufficiale richieda markup appropriato. Questa discrepanza tra requisiti ufficiali e comportamento osservato ha portato molti professionisti SEO a utilizzare l’API in modo più ampio, sebbene Google raccomandi una stretta aderenza alle linee guida ufficiali per evitare la potenziale revoca dell’accesso.

Impatto sulla Visibilità di Ricerca e sulla Velocità di Posizionamento

L’Indexing API accelera notevolmente il tempo tra la pubblicazione dei contenuti e la loro visibilità nei motori di ricerca. L’indicizzazione tradizionale tramite scansione e scoperta tramite sitemap può richiedere da ore a settimane, a seconda del crawl budget e dell’autorità del tuo sito. Con l’Indexing API, le pagine vengono tipicamente scansionate entro pochi minuti dall’invio della notifica. Casi studio di settore dimostrano che i siti web di notizie che utilizzano l’Indexing API raggiungono l’indicizzazione entro 30 minuti o 2 ore, rispetto alle 15-48 ore per gli approcci basati solo su sitemap. Questo vantaggio in termini di velocità è particolarmente prezioso per contenuti sensibili al fattore tempo come notizie dell’ultima ora, lanci di prodotti, offerte di lavoro e offerte a tempo limitato. Un’indicizzazione più rapida si traduce direttamente in un vantaggio competitivo: i tuoi contenuti possono posizionarsi e catturare traffico di ricerca prima che i contenuti simili dei concorrenti siano persino scoperti. Per i siti di e-commerce, l’indicizzazione rapida delle nuove pagine prodotto significa una visibilità più rapida nei risultati di ricerca dei prodotti. Per i portali di lavoro, l’indicizzazione immediata garantisce che gli annunci di lavoro appaiano nei risultati di Google Jobs mentre sono ancora attivamente oggetto di reclutamento.

Integrazione con Sistemi di Gestione dei Contenuti e Piattaforme

La maggior parte dei sistemi di gestione dei contenuti moderni offre ora supporto integrato o basato su plugin per l’Indexing API. Gli utenti di WordPress possono sfruttare plugin come Rank Math Instant Indexing o plugin autonomi per l’indicizzazione rapida che inviano automaticamente gli URL all’API ogni volta che i post vengono pubblicati o aggiornati. I proprietari di negozi Shopify possono utilizzare app di terze parti o script personalizzati per integrare gli invii API con gli aggiornamenti dei prodotti. Gli sviluppatori Webflow possono implementare l’API tramite codice personalizzato o piattaforme di automazione come Zapier. I negozi WooCommerce possono utilizzare plugin SEO che supportano invii API automatici. Per siti web personalizzati e piattaforme aziendali, gli sviluppatori possono integrare l’API direttamente nel flusso di lavoro di pubblicazione del backend, assicurando che ogni aggiornamento dei contenuti attivi automaticamente una notifica di indicizzazione. Questa diffusa integrazione significa che molti proprietari di siti web beneficiano dell’Indexing API senza configurarlo esplicitamente: la loro piattaforma gestisce l’implementazione tecnica automaticamente.

Considerazioni Chiave sull’Implementazione e Best Practice

• Invia solo contenuti di alta qualità e originali tramite l’API per mantenere la tua quota ed evitare potenziali restrizioni di accesso
• Utilizza l’API in modo selettivo per pagine sensibili al fattore tempo o di alto valore, piuttosto che inviare ogni pagina del tuo sito
• Combina l’API con gli XML sitemap per una copertura completa — i sitemap forniscono un inventario completo degli URL mentre l’API accelera la scoperta degli aggiornamenti
• Mantieni dati strutturati corretti sulle pagine che invii, specialmente per i tipi di contenuto JobPosting e BroadcastEvent
• Monitora l’utilizzo della tua quota tramite la Google Cloud Console per evitare di superare i limiti giornalieri
• Implementa la gestione degli errori nella tua integrazione per gestire con garbo i fallimenti dell’API o l’esaurimento della quota
• Testa accuratamente prima di distribuire in produzione, utilizzando la Console API per verificare gli invii riusciti
• Mantieni al sicuro le credenziali del tuo account di servizio e ruota periodicamente le chiavi JSON per le best practice di sicurezza
• Documenta l’implementazione della tua API per il tuo team per garantire un utilizzo e una manutenzione coerenti
• Traccia le prestazioni dell’indicizzazione confrontando le date di scansione prima e dopo l’implementazione dell’API per misurare l’impatto

Verificare se la Tua Implementazione dell’Indexing API Funziona Effettivamente

Verificare che l’API funzioni correttamente richiede di controllare più del semplice fatto che le richieste restituiscano uno stato 200. Passaggio 1: Conferma che l’autenticazione sia genuinamente valida, non solo configurata. Controlla che l’account di servizio sia elencato come Proprietario (non solo come utente) in Google Search Console per la proprietà verificata — un account di servizio con autorizzazioni insufficienti può comunque autenticarsi con successo mentre fallisce silenziosamente nella registrazione delle notifiche. Passaggio 2: Controlla il consumo di quota rispetto al volume di invio effettivo. Estrai i dati di utilizzo dalla Google Cloud Console e confrontali con quanti URL ritieni di inviare quotidianamente — una discrepanza indica invii duplicati o un’integrazione difettosa che fallisce silenziosamente su alcune pagine. Passaggio 3: Interroga l’endpoint dei metadati per un campione di URL inviati. L’endpoint /urlNotifications/metadata restituisce il timestamp dell’ultima notifica ricevuta da Google per un determinato URL — se questo timestamp non corrisponde al tuo invio recente, la notifica non sta raggiungendo Google nonostante il tuo sistema segnali un successo. Passaggio 4: Verifica l’idoneità del tipo di contenuto. Poiché il supporto ufficiale dell’API è limitato ai dati strutturati JobPosting e BroadcastEvent, conferma che le pagine che stai inviando contengano effettivamente quel markup dello schema in modo corretto — utilizza il Test dei Risultati Ricchi di Google per validare il markup indipendentemente dall’invio API. Passaggio 5: Confronta la velocità di indicizzazione effettiva prima e dopo l’implementazione. Controlla le date di scansione nello Strumento di Ispezione URL di Search Console per le pagine inviate di recente rispetto a un set di base di pagine che non sono state inviate tramite l’API — se non c’è una differenza significativa nel tempo di scansione, l’integrazione potrebbe essere configurata in modo errato anche se riporta un successo.

+++