API Reference

L'API Search Console offre i seguenti servizi:

  • Search Analytics: esegui query sui dati relativi al traffico per il tuo sito.
  • Sitemap: elenca tutte le Sitemap, richiedi informazioni relative a una Sitemap specifica e inviala a Google.
  • Siti: elenca/aggiungi/rimuovi proprietà dal tuo account Search Console
  • Controllo URL: controlla lo stato di una pagina nell'Indice Google (equivalente a Controllo URL in Search Console).

Analisi delle ricerche

Per i dettagli delle risorse di Search Analytics, consulta la pagina Rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/webmasters/v3, se non diversamente specificato
query POST  /sites/siteUrl/searchAnalytics/query

Esegui una query sui dati del traffico di ricerca utilizzando filtri e parametri da te definiti. Il metodo restituisce zero o più righe raggruppate in base alle chiavi di riga (dimensioni) definite. Devi definire un intervallo di date di uno o più giorni.

Se la data è una delle dimensioni, tutti i giorni senza dati vengono omessi dall'elenco dei risultati. Per sapere in quali giorni sono presenti dati, genera una query senza filtri raggruppati per data per l'intervallo di date di interesse.

I risultati vengono ordinati per numero di clic in ordine decrescente. Se due righe hanno lo stesso numero di clic, vengono ordinate in modo arbitrario.

Vedi l'esempio di Python per chiamare questo metodo.

Esempio di post JSON:
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}

Sitemap

Per i dettagli sulle risorse Sitemap, consulta la pagina Rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/webmasters/v3, se non diversamente specificato
elimina DELETE  /sites/siteUrl/sitemaps/feedpath Elimina una Sitemap dal sito.
ricevi GET  /sites/siteUrl/sitemaps/feedpath Recupera le informazioni su una Sitemap specifica.
list GET  /sites/siteUrl/sitemaps Elenca le Sitemap-voci inviate per questo sito o incluse nel file indice Sitemap (se nella richiesta è specificato sitemapIndex).
invia PUT  /sites/siteUrl/sitemaps/feedpath Invia una Sitemap per un sito.

Siti

Per i dettagli della risorsa Sites, consulta la pagina rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativi a https://www.googleapis.com/webmasters/v3, se non diversamente specificato
add PUT  /sites/siteUrl Aggiunge un sito all'insieme dei siti dell'utente in Search Console.
elimina DELETE  /sites/siteUrl Rimuove un sito dall'insieme dei siti di Search Console dell'utente.
ricevi GET  /sites/siteUrl Recupera le informazioni su un sito specifico.
list GET  /sites Elenca i siti di Search Console dell'utente.

Controllo URL

Per i dettagli sulle risorse di Controllo URL, consulta la pagina Rappresentazione delle risorse.

Metodo Richiesta HTTP Descrizione
URI relativo a https://searchconsole.googleapis.com/v1
index.inspect POST /urlInspection/index:inspect

Informazioni sull'URL fornito nell'Indice Google.

Esempio di post JSON:
POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect
{
  "inspectionUrl": "https://www.example.com/mypage",
  "siteUrl": "https://www.example.com/",
  "languageCode": "en-US"}