Miércoles 9 de diciembre de 2020
Hace unos meses, anunciamos que habría una actualización de la infraestructura de la API con el fin de mejorar el rendimiento de la API de Search Console a medida que crece la demanda. Hoy, nos complace anunciar que hay más actualizaciones en camino:
- Incorporación de datos recientes y filtro de noticias en la API de Search Console
- Compatibilidad de las propiedades de dominio con la API de Sitemaps
- Lineamientos para migrar el documento de descubrimiento
Si realizas tus propias llamadas a la API, continúa leyendo.
Datos recientes y filtro de noticias en la API de Search Console
El Informe de rendimiento ahora admite datos recientes que tienen menos de un día de antigüedad. Puedes acceder a esos datos a través de la API pasando el parámetro de solicitud dataState con el valor establecido en all. Los datos que obtengas con ese valor también incluirán datos recientes que aún no son definitivos. Si quieres obtener únicamente los datos finales, puedes pasar este parámetro con el valor establecido en final o no pasarlo en absoluto, y solo obtendrás los datos finales de forma predeterminada.
Hace unos meses, agregamos al Informe de rendimiento una pestaña Noticias en el filtro de la Búsqueda. Esa información ahora está disponible en la API, y puedes acceder a ella estableciendo el valor del parámetro searchType de la solicitud como news.
Compatibilidad de las propiedades de dominio con la API de Sitemaps
De la misma manera que otras API de Search Console ya admitían las propiedades de dominio, ahora también lo hace la API de Sitemaps. Puedes consultar, agregar y borrar tus mapas del sitio en las propiedades de dominio, como en el siguiente ejemplo:
GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps
Migración de documentos de descubrimiento
Quitaremos la compatibilidad con el documento de descubrimiento para Webmasters. Si realizas una consulta a la API de Search Console mediante una biblioteca de API externa o directamente al documento de descubrimiento de la API para Webmasters, deberás actualizar tus llamadas a la API para incluir los siguientes cambios.
Cambios en la biblioteca de API
Para ver actualizaciones sobre los cambios en la biblioteca de la API, consulta las guías de inicio rápido de Java y Python, y obtén una guía de uso de la API actualizada.
Java
Para todas las importaciones relacionadas con el servicio para webmasters, cambia el paquete webmasters por el paquete searchconsole.v1 y el nombre del servicio, Webmasters, a SearchConsole. Ejemplos:
- Importación del servicio de API:
import com.google.api.services.webmasters.Webmasters;import com.google.api.services.searchconsole.v1.SearchConsole; - Importación de 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 los mismos que antes, solo cambia el paquete.
Python
Cuando crees el objeto de servicio para webmasters, haz el siguiente cambio:
webmasters_service = build('webmasters', 'v3', http=http)
webmasters_service = build('searchconsole', 'v1', http=http)
Nuevamente, no hay cambios en el comportamiento de los objetos.
Consulta sobre documentos de descubrimiento directo
Entre los cambios de las consultas de documentos de descubrimiento, se incluyen los siguientes:
- Cambios en la URL
https://www.googleapis.com/discovery/v1/apis/webmasters/v3/resthttps://searchconsole.googleapis.com/$discovery/rest - Cambios de contenido
- El campo
namecambió dewebmastersasearchconsole. - El campo
versioncambió dev3av1.
- El campo
Si tienes alguna pregunta, puedes compartirla en la comunidad de la Central de la Búsqueda o en Twitter.