L'API Search Console offre i seguenti servizi:
- Analisi delle ricerche: esegui query sui dati sul traffico relativi al tuo sito.
- Sitemap: elenca tutte le Sitemap, richiedi informazioni su una Sitemap specifica e invia una Sitemap a Google.
- Siti: elenca/aggiungi/rimuovi proprietà dall'account Search Console.
- Controllo URL: controlla lo stato di una pagina nell'Indice Google (equivalente al Controllo URL in Search Console).
Analisi delle ricerche
Per i dettagli sulle risorse di Analisi delle ricerche, consulta la pagina sulla 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 query sui dati del traffico di ricerca con filtri e parametri da te definiti. Il metodo restituisce zero o più righe raggruppate in base alle chiavi di riga (dimensioni) che hai definito. 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 quali giorni contengono dati, esegui una query senza filtri raggruppati per data, per l'intervallo di date di interesse. I risultati vengono ordinati in base al conteggio dei 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 su 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 delle risorse Sitemap, consulta la pagina sulla 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 da questo sito. |
| trova |
GET /sites/siteUrl/sitemaps/feedpath
|
Recupera le informazioni su una Sitemap specifica. |
| list |
GET /sites/siteUrl/sitemaps
|
Elenca le Sitemap-entries inviate per il sito o incluse nel file Indice Sitemap (se nella richiesta è specificato sitemapIndex).
|
| invia |
PUT /sites/siteUrl/sitemaps/feedpath
|
Invia la Sitemap relativa a un sito. |
Siti
Per i dettagli sulle risorse Sites, consulta la pagina sulla 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 di siti dell'utente in Search Console. |
| elimina |
DELETE /sites/siteUrl
|
Rimuove un sito dall'insieme di siti di Search Console dell'utente. |
| trova |
GET /sites/siteUrl
|
Recupera informazioni su un sito specifico. |
| list |
GET /sites
|
Elenca i siti Search Console dell'utente. |
Controllo URL
Per i dettagli sulle risorse Controllo URL, consulta la pagina sulla 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 su JSON:
POST https://searchconsole.googleapis.com/v1/urlInspection/index:inspect
{
"inspectionUrl": "https://www.example.com/mypage",
"siteUrl": "https://www.example.com/",
"languageCode": "en-US"} |