Aggiornamenti all'API Search Console

Mercoledì 9 dicembre 2020

Alcuni mesi fa abbiamo annunciato un upgrade dell'infrastruttura dell'API per migliorare le prestazioni dell'API Search Console con l'aumentare della domanda. Oggi siamo lieti di annunciare altri aggiornamenti in arrivo per voi:

Se effettuate chiamate all'API, continuate a leggere.

Filtro di notizie e dati aggiornati nell'API Search Console

Il report sul rendimento supporta già dati aggiornati risalenti a meno di un giorno prima della data corrente. Ora potete accedere a questi dati tramite l'API passando il parametro di richiesta dataState con il valore impostato su all. I dati che riceverete per questo valore includeranno anche dati aggiornati non ancora definitivi. Se volete ricevere per impostazione predefinita soltanto i dati definitivi, potete passare questo parametro con il valore impostato su final o non passarlo affatto.

Alcuni mesi fa abbiamo aggiunto al report sul rendimento una scheda Notizie nel filtro di ricerca. Queste informazioni sono ora disponibili anche nell'API e potete accedervi impostando il valore news per il parametro searchType nella richiesta.

Supporto delle proprietà Dominio nell'API Sitemaps

L'API Sitemaps ora supporta le proprietà Dominio, come fanno già altre API Search Console. Potete eseguire query, aggiungere ed eliminare Sitemap nelle proprietà Dominio, ad esempio:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Migrazione del documento di rilevamento

Ritireremo il supporto nel documento di rilevamento dell'API Webmasters. Se inviate query all'API Search Console usando una libreria API esterna o se inviate query dirette al documento di rilevamento dell'API Webmasters, dovrete aggiornare le chiamate API per includere le modifiche indicate di seguito.

Modifiche alla libreria API

Per aggiornamenti sulle modifiche apportate alla libreria API, consultate le guide rapide di Java e Python per avere una guida all'utilizzo dell'API aggiornata.

Java

Per tutte le importazioni correlate al servizio Webmasters, impostate il pacchetto webmasters sul pacchetto searchconsole.v1, quindi il nome del servizio Webmasters su SearchConsole. Esempi:

  • Importazione del servizio API:

    import com.google.api.services.webmasters.Webmasters;

    import com.google.api.services.searchconsole.v1.SearchConsole;

  • Importazione di un oggetto di risposta:

    import com.google.api.services.webmasters.model.WmxSite;

    import com.google.api.services.searchconsole.v1.model.WmxSite;

Tenete presente che, a parte l'oggetto del servizio, gli altri oggetti API sono identici a prima, cambia solo il pacchetto.

Python

Quando create l'oggetto del servizio Webmasters, apportate la seguente modifica:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

Anche in questo caso, il comportamento degli oggetti rimane inalterato.

Query dirette al documento di rilevamento

Le modifiche apportate alle query al documento di rilevamento includono:

  • Modifica degli URL

    https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

    https://searchconsole.googleapis.com/$discovery/rest

  • Modifica dei contenuti
    • Il campo name è stato modificato da webmasters a searchconsole.
    • Il campo version è stato modificato da v3 a v1.

In caso di domande, potete rivolgervi alla community di Search Central o contattarci su Twitter.

Pubblicato da Nati Yosephian, Gilad Amar e Michael Huzman, team di Search Console