Wednesday, December 9, 2020
A few months ago we announced an API infrastructure upgrade
to improve the performance of the Search Console API as demand grows. Today we’re happy to announce
some more updates coming your way:
- Addition of fresh data & news filter in the Search Console API
- Domain property support in the Sitemaps API
- Guidelines on how to migrate the Discovery doc
If you make your own calls to the API, read on.
Fresh data & news filter in the Search Console API
The Performance report already supports fresh data that is less than a day old. You can now access this data through the API by passing the request parameter
dataState
with value set to all
. The data you get for this value will also include fresh data that is not yet final. If you wish to get only final data,
you can either pass this parameter with value set to final
or not pass it at all and you will get only final data by default.
A few months ago, we added a News tab on Search filter to the
Performance report. This information is now also available in the API, and you can access it by setting the value of searchType
parameter in the request to news
.
Domain property support in the Sitemaps API
The Sitemaps API now supports domain properties, as other Search Console APIs already do. You can query, add, and delete your sitemaps on
domain properties, for example:
GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps
Discovery doc migration
We’ll drop the support in the Webmasters discovery document. If you’re querying the Search Console API using an external API library, or querying
the Webmasters API discovery document directly, you will
need to update your API calls to include the following changes.
API library changes
For updates on the API library changes, refer to the Java and
Python quickstart guides,
for an updated API usage guide.
Java
For all Webmasters service-related imports, change the webmasters
package to the searchconsole.v1
package,
and the service name, Webmasters
, to SearchConsole
. Examples:
- Importing the API service:
import com.google.api.services.webmasters.Webmasters;
import com.google.api.services.searchconsole.v1.SearchConsole;
- Importing a response object:
import com.google.api.services.webmasters.model.WmxSite;
import com.google.api.services.searchconsole.v1.model.WmxSite;
Note that besides the service object, other API objects are exactly the same as before, only the package changes.
Python
When building the Webmasters service object, make the following change:
webmasters_service = build('webmasters', 'v3', http=http)
webmasters_service = build('searchconsole', 'v1', http=http)
Again, there’s no change in how objects behave.
Direct discovery document query
The discovery document querying changes include:
If you have any questions, feel free to ask in the Search
Central community or on Twitter.