Visualizador de transferencias

El Visualizador de la incorporación (al que se puede acceder en Incorporación > Historial en el Actions Center) proporciona visibilidad casi en tiempo real del estado, el estado de validación y el historial de procesamiento de los feeds de lugares de interés locales.

Usa el Visualizador de la incorporación para hacer un seguimiento de las cargas diarias de feeds, supervisar el estado de la incorporación, inspeccionar las estadísticas de errores de validación a nivel del artículo y verificar la llegada de los archivos de feeds.

Descripción general

En la página principal del Visor de transferencias, se muestra un registro cronológico inverso de cada feed que recibió Google.

Fases del ciclo de vida de la transferencia

Cada envío de feed avanza por las siguientes etapas de procesamiento secuencial:

  1. Adquisición de archivos: Google recibe el archivo de feed a través de SFTP.
  2. Validación de archivos: El sistema verifica la integridad, la descompresión y el formato general del esquema del archivo.
  3. Extracción y validación de entidades: La canalización analiza registros locales individuales (poi_id, dirección, coordenadas, localizaciones) y verifica la sintaxis, la integridad y el cumplimiento de las políticas.
  4. Conciliación y coincidencia: Las entidades válidas se pasan al motor de coincidencias de Google para vincularse con los IDs canónicos de Google Places para la publicación.
  5. Generación de informes: Las métricas de resumen y los diagnósticos de problemas agrupados se publican en el Visualizador de transferencia.

Para ver tu historial de transferencia de feeds, completa los siguientes pasos:

  1. Accede al Actions Center.
  2. Abre la página Ingestion > History.
  3. Filtra, ordena y visualiza la tabla de transferencia con los controles de columna.

Columnas de la lista de transferencia

En la tabla de resumen principal, se proporcionan las siguientes columnas para cada ejecución de la transferencia de datos:

Columna Tipo de datos Descripción
ID String Es el identificador único de la ejecución de la transferencia.
Hora de la transferencia (UTC) Timestamp Fecha y hora (en UTC) en que Google comenzó a procesar la incorporación del feed.
Tipo de transferencia Enum Tipo de adquisición de datos (p.ej., Feed).
Nombre String Es el nombre del tipo de transferencia de datos del feed. Será google.local_vss.
Estado State Estado general del procesamiento de la transferencia (p.ej., Completado, Con errores). Consulta las definiciones de estado.
Comportamiento de transferencia Enum Todos los feeds de PDI locales se procesan en modo Batch.
Errores Integer Es el recuento total de los problemas de validación a nivel de error que se detectaron y que impiden la publicación.
Advertencias Integer Es el recuento total de problemas detectados a nivel de advertencia que no bloquean.
Elementos Integer Es la cantidad total de propiedades locales procesadas en esta transferencia.

Definiciones de estado

La columna Estado indica el estado operativo actual de un envío de feed:

  • Listo (STATUS_COMPLETE): El feed se transfirió, validó y procesó correctamente sin errores fatales.
  • Con errores (STATUS_FAILED): La transferencia encontró errores fatales de esquema o de canalización, o bien corrupción de archivos, y no se pudo completar.
  • Procesando (STATUS_PROCESSING): Google está validando, correlacionando y almacenando activamente los datos del feed.
  • Omitido (NOT_STARTED): Se omitió la carga del feed (por ejemplo, si la marca de tiempo de generación es anterior a un feed procesado anteriormente).

Vista de detalles de transferencia

Haz clic en cualquier fila de la tabla del Visor de Ingestión para abrir la Vista de Detalles de Ingestión. En esta vista, se proporcionan tarjetas de diagnóstico integrales y paneles de expansión para depurar problemas.

Paneles de detalles

La página de detalles de la transferencia se divide en cuatro secciones desplegables:

1. Información básica

Muestra los metadatos principales sobre la ejecución:

  • Hora de la transferencia (UTC): Es la marca de tiempo en la que Google comenzó la transferencia.
  • Tipo de transferencia: Feed.
  • Nombre: google.local_vss.
  • Comportamiento de transferencia: Batch
  • Estado: Es una insignia de estado codificada por colores (Done, Failed, Processing, Skipped).

2. Validaciones

Enumera todos los resultados de validación encontrados durante la transferencia:

  • Errores de archivo (cuadro de texto): Si falló todo el archivo del feed (por ejemplo, debido a un archivo ilegible o a una sintaxis JSON con formato incorrecto), se mostrará un cuadro de texto de advertencia destacado con el mensaje de la causa raíz.
  • Problemas de entidades (Tabla de acordeón): Problemas de validación a nivel del artículo agrupados por gravedad y código de error.
    • Código del problema: Es el identificador de error específico (por ejemplo, INVALID_ATTRIBUTE_VALUE, MISSING_RECOMMENDED_FIELD o SAFE_SEARCH_POLICY_VIOLATION_TEXT).
    • Issue Info: Es la descripción del diagnóstico que explica la causa raíz y los campos afectados.
    • Registros: Es el recuento total de entidades de propiedad afectadas por este problema.
    • Haz clic en cualquier fila de problemas para expandir los IDs de entidades de muestra (poi_ids) con vínculos directos para inspeccionar las propiedades en el Visualizador de inventario.

3. Elementos

Proporciona cuadros de evaluación comparativa del delta del inventario a nivel del artículo para la ejecución de la transferencia:

  • Total: Es la cantidad total de propiedades locales procesadas.
  • Agregadas: Es la cantidad de fichas de empresas descubiertas recientemente que se agregaron a tu catálogo.
  • Cambiado: Es el recuento de las propiedades existentes cuyos atributos (p.ej., nombre, dirección, coordenadas o imágenes) se actualizaron.
  • Quitadas: Es el recuento de las propiedades que se quitaron o se omitieron en comparación con el valor de referencia del feed anterior.

4. Archivos

Muestra el nombre del archivo del feed subido:

  • Nombre del archivo: Nombre del archivo de feed (por ejemplo, local_feed.json.gz).

Solución de problemas de fallas de transferencia

Cuando soluciones problemas relacionados con los feeds en el Visor de transferencias, usa los siguientes lineamientos:

Síntoma Causa probable Acción recomendada
El estado es Failed con error de archivo El archivo ZIP o GZIP está dañado, la sintaxis de JSON no es válida o la codificación del archivo no es compatible. Verifica que tu feed esté empaquetado correctamente con los Lineamientos para el empaquetado de feeds.
Recuento Errors alto en Validaciones Faltan campos de esquema obligatorios (como poi_id, location.address estructurado o coordenadas WGS84) en los registros. Revisa el acordeón expandido Validaciones para identificar los poi_ids infractores, corrige tus canalizaciones de feeds de PDI y vuelve a importar el feed.
Cero Items procesado El archivo de feed está vacío o no se pudo analizar el array JSON de nivel raíz de los registros. Verifica que la estructura del wrapper de tu feed cumpla con la especificación del mensaje VssPoi. Consulta los Lineamientos para el empaquetado de feeds.