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