Novedades de la API de Search Console

Miércoles, 9 de diciembre del 2020

Hace unos meses anunciamos que renovaríamos la infraestructura de las API para mejorar el rendimiento de la API de Search Console de modo que pueda satisfacer el aumento de la demanda. Hoy por fin podemos anunciar que también hemos hecho estos cambios:

  • Hemos incluido datos actualizados y un filtro de noticias en la API de Search Console
  • La API Sitemaps ahora es compatible con propiedades de dominios
  • Hemos recopilado directrices sobre cómo migrar el documento de descubrimiento

Si haces llamadas manuales a la API, sigue leyendo.

Datos actualizados y filtro de noticias en la API de Search Console

En el informe "Rendimiento" ya se pueden mostrar datos actualizados que tienen menos de un día de antigüedad. Ahora puedes acceder a esos datos con la API enviando el parámetro de solicitud dataState con el valor all. Si usas este valor, en la respuesta a la solicitud también se incluirán datos actualizados provisionales. Para ver solo datos definitivos, puedes enviar ese parámetro con el valor final o sencillamente no incluirlo en la solicitud, ya que de forma predeterminada solo se devuelven datos definitivos.

Hace unos meses, añadimos la pestaña Noticias al filtro de Búsqueda del informe "Rendimiento". Ahora también puedes consultar esta información con la API; solo tienes que dar el valor news al parámetro searchType de la solicitud.

La API Sitemaps ahora es compatible con propiedades de dominios

La API Sitemaps ahora es compatible con las propiedades de dominio, al igual que otras API de Search Console. Puedes consultar, añadir y eliminar los sitemaps que tengas en propiedades de dominio; por ejemplo:

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

Migración del documento de descubrimiento

Desasistiremos el documento de descubrimiento de Webmasters. Si envías consultas a la API de Search Console mediante una biblioteca de API externa o consultas directamente el documento de descubrimiento de la API de Webmasters, tendrás que modificar las llamadas que haces a la API de la forma que se indica a continuación.

Cambios en las bibliotecas de la API

Para saber qué ha cambiado en las bibliotecas de la API y cómo usarlas ahora, consulta las guías de inicio rápido de Java y de Python.

Java

En todas las tareas de importación relacionadas con el servicio de Webmasters, cambia el paquete webmasters por el paquete searchconsole.v1 y el nombre de servicio Webmasters por SearchConsole. Ejemplos:

  • Importar el servicio de la API:

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

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

  • Importar un objeto de respuesta:

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

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

Ten en cuenta que, además del objeto de servicio, otros objetos de la API son exactamente iguales que antes; solo ha cambiado el paquete.

Python

Cuando crees el objeto del servicio de Webmasters, haz este cambio:

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

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

Los objetos funcionan igual que antes.

Consultas directas al documento de descubrimiento

Estos son los cambios que deben hacerse en las consultas al documento de descubrimiento:

  • Cambio de URL

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

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

  • Cambio de contenido
    • El campo name ha cambiado de webmasters a searchconsole.
    • El campo version ha cambiado de v3 a v1.

Si tienes alguna pregunta, puedes publicarla en la comunidad del Centro de la Búsqueda o en Twitter.

Publicado por Nati Yosephian, Gilad Amar y Michael Huzman, miembros del equipo de Search Console