Kit Digital - ayudas económicas para la transformación digital
Google Analytics 4: cómo actualizar y empezar a usar el nuevo GA4
Pin it

api de inspeccion de url de google search console

Google Search Console estrena nueva API de inspección de URL para que los SEO y desarrolladores puedan solicitar a Google mediante programación la indexación de nuevas páginas de las propiedades que administran en Search Console.

Al usar la nueva API de indexación, Google priorizará estas URL para rastrearlas e indexarlas antes que otras

Con la API de inspección de URLs, puedes:

  • Actualizar URLs en el índice
  • Eliminar URLs del índice
  • Obtener el estado de la última solicitud
  • Enviar solicitudes por lotes para reducir el número de llamadas a la API

Límites de uso

La API de inspección de URL de Search Console tiene límites de uso, por lo que probablemente no podrás ejecutarla en todas las URL de todos tus sitios en un solo día.

Estos límites de uso son:

  • 2.000 consultas por día y por propiedad
  • 600 consultas por minuto

Ejemplos de uso

En general, las API de Search Console son una forma de acceder a datos de GSC que usan los desarrolladores y las herramientas SEO a través de aplicaciones y productos externos, para crear soluciones personalizadas que permiten ver, agregar o eliminar propiedades y sitemaps, y ejecutar consultas avanzadas sobre los datos de rendimiento de búsqueda.

A nivel práctico, las API de GSC permiten acceso a la gestión y los datos de Search console sin salir del panel de Wordpress, Joomla o tu CMS favorito, utilizando un componente o un plugin.

Con la nueva API de inspección de URL, Google proporciona una herramienta para que los desarrolladores automaticen el seguimiento de sus páginas solicitando los datos que Search Console tiene sobre la versión indexada de una URL.

Con la nueva API de inspección de URL, Google proporciona una herramienta para que los desarrolladores automaticen el seguimiento de sus páginas solicitando los datos que Search Console tiene sobre la versión indexada de una URL.

Por ejemplo, los desarrolladores de complementos y CMS pueden añadir análisis automatizados que permitirán monitorizar los cambios a lo largo del tiempo, permitiendo diagnosticar problemas en las páginas principales y ayudar a priorizar las soluciones.

La API devolverá la información de indexación disponible en la herramienta de inspección de URL, lo que permitirá verificar si hay diferencias entre las páginas canónicas declaradas por el usuario y las seleccionadas por Google, o depurar problemas de datos estructurados de un grupo de páginas.

También podrás enviar solicitudes de inspección de páginas individuales al terminar de publicarlas.

Este es el ejemplo de respuesta de la API que aparece en el anuncio de Google: Welcoming the new Search Console URL Inspection API

  {
 
"inspectionResult": {
   
"inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://developers.google.com/search/&id=odaUL5Dqq3q8n0EicQzawg&utm_medium=link&utm_source=api",
   
"indexStatusResult": {
     
"verdict": "PASS",
     
"coverageState": "Indexed, not submitted in sitemap",
     
"robotsTxtState": "ALLOWED",
     
"indexingState": "INDEXING_ALLOWED",
     
"lastCrawlTime": "2022-01-31T08:39:51Z",
     
"pageFetchState": "SUCCESSFUL",
     
"googleCanonical": "https://developers.google.com/search/help/site-appearance-faq",
     
"userCanonical": "https://developers.google.com/search/help/site-appearance-faq",
     
"referringUrls": [
       
"https://developers.google.com/search/updates",
       
"https://developers.google.com/search/help/crawling-index-faq"
     
],
     
"crawledAs": "MOBILE"
   
},
   
"mobileUsabilityResult": {
     
"verdict": "PASS"
   
},
   
"richResultsResult": {
     
"verdict": "PASS",
     
"detectedItems": [
       
{
         
"richResultType": "Breadcrumbs",
         
"items": [
           
{
             
"name": "Unnamed item"
           
}
         
]
       
},
       
{
         
"richResultType": "FAQ",
         
"items": [
           
{
             
"name": "Unnamed item"
           
}
         
]
       
}
     
]
   
}
 
}
}

¿Cómo se utiliza la API de Inspección de URL?

Los parámetros de la solicitud incluyen la URL que deseas inspeccionar y la URL de la propiedad tal como se define en Search Console.

En todos los casos, deberás tener acceso adecuado (propietario, completo, lectura) a cualquier cuenta de Google Search Console a la que desees acceder mediante la API.

Una vez que realices la llamada a la API, obtendrás una respuesta con todos los resultados relevantes o un mensaje de error si la solicitud falla.

Si falta un resultado de análisis específico en la respuesta, significa que el análisis no estaba disponible para la URL inspeccionada.

La respuesta incluye resultados de análisis que contienen información de Search Console incluido el estado del índice, estado de AMP, resultados enriquecidos y usabilidad móvil.

Consulta más detalles en la lista de parámetros y la explicación de los resultados de la URL indexada.

Ejemplos prácticos

Si quieres probrar la API, puedes hacerlo usando Google Sheet con esta plantilla de Mike Richardson.

Para ello tendrás que crear un proyecto de API en Google Developer Console y crear una cuenta de servicio en Google Cloud Platform para dar de alta las credenciales de la API.

Cuando obtengas las claves de API podrás activar la API de inspección de URLs en tu proyecto. Aquí tienes un tutorial para usarla.

Si eres un desarrollador y quieres probrar la API usando Python, Aquí puedes ver un artículo muy detallado de Jean-Christophe Chouinard.

Para aprender a usar la nueva API, consulta la documentación para desarrolladores de la API.

­