Vista de inventario

Descripción general

El Visualizador de inventario de Actions Center proporciona visibilidad sobre el estado de la transferencia, el estado de coincidencia de lugares y la elegibilidad para la publicación de tu inventario local de lugares de interés (POI).

Este visor muestra los problemas de forma independiente de las transferencias individuales, es decir, problemas con estado que representan el estado de publicación activo de cada proveedor de servicios, lo que incorpora cualquier posible modo de falla (política, advertencias, errores, etc.) que pueda ocurrir.

Utilice esta herramienta para:

  • Busca e inspecciona todos los proveedores de servicios transferidos y sus estados de publicación en vivo.
  • Diagnosticar errores de validación de datos y de incumplimiento de políticas de contenido
  • Envía y haz un seguimiento de las apelaciones por cualquier incumplimiento de política.
  • Inspeccionar los diagnósticos de coincidencias de los proveedores de servicios y enviar propuestas de coincidencias manuales
  • Revisa las cargas útiles de JSON sin procesar de tus transferencias de feeds más recientes.

Columnas de la tabla de inventario

En la vista de lista, se muestran todos los proveedores de servicios subidos desde tu feed de puntos de interés (PI), organizados de forma jerárquica por entidad. Puedes filtrar por ID de lugar de interés local, estado de coincidencia, integración y plataforma.

Columnas de la tabla de resumen Descripción
ID del lugar de interés local Es el identificador único de la propiedad local que se proporciona en el feed (poi_id).
Nombre del lugar de interés en idioma local Es el nombre localizado de la propiedad local extraída del feed.
Estado de coincidencia Indica si el PDI se vinculó a una ficha de Google Maps:
• Sí (insignia verde): Se vinculó correctamente a un lugar de Google Maps.
• No (insignia roja): No hay coincidencia; se requiere una revisión o una propuesta de coincidencia.
Integración Esta es la integración de la unidad de agregador local.
Surface La plataforma de publicación de destino (p. ej., la Búsqueda)
Estado de publicación El estado de elegibilidad de publicación en tiempo real:
• Habilitado (indicador verde): Es apto y se puede publicar activamente en las plataformas de Google.
• Inhabilitado (indicador rojo): Se bloqueó la publicación debido a errores de validación, incumplimientos de política o estado no coincidente.
Errores Es el recuento de problemas activos con una gravedad de error. La existencia de cualquier error en una propiedad significa que esta no será apta para publicarse en ninguna plataforma.
Advertencias Es el recuento de problemas activos con una gravedad de advertencia. Las propiedades con advertencias siguen siendo aptas para publicarse.
Información del partido Contiene el botón Editar coincidencia, que abre el panel interactivo de corrección de coincidencias.

Vista de detalles de lugares de interés

Si haces clic en cualquier ID de lugar de interés en la vista de lista, se abrirá la página de detalles dedicada de la entidad.

La vista de detalles consta de cuatro secciones expandibles:

1. Información básica

Resume los metadatos de la entidad de alto nivel:

  • Nombre del lugar de interés: Es el nombre del establecimiento, según se analizó de data[].name.localizations.
  • ID de lugar de interés: Es el identificador único de la entidad del socio (poi_id).
  • Fuente de datos: Es el nombre exacto del archivo del feed desde el que se transfirió esta entidad.

2. Información sobre el estado

Desglosa la elegibilidad de publicación por integración y plataforma de destino:

  • Integración y plataforma: Vertical y plataforma de destino (p.ej., Local Aggregator Unit en Search).
  • Estado de publicación: Es el estado actual de Enabled o Disabled.
  • Problemas: Muestra insignias de problemas para todos los errores o advertencias activos (p.ej., Unmatched entity, Policy Violation). Si haces clic en una insignia de problema, se abrirá el panel de detalles del problema.
  • Apelaciones: Muestra los estados de anulación o apelación (Under review, Approved o Rejected).

3. Información de coincidencia

Muestra diagnósticos de coincidencias de lugares:

  • Entrada de coincidencia: Es la dirección física con formato que se analiza de tu feed (street_address, locality, region, postal_code, country).
  • Tipo de coincidencia: Es el mecanismo de resolución de coincidencias (p.ej., Location).
  • Espacio de nombres de coincidencias: Es la vertical a la que se aplicarán los cambios de coincidencias (p.ej., Local Aggregator Unit).
  • Estado de coincidencia: Yes (verde) o No (rojo).
  • Resultado de la coincidencia: El nombre, la dirección y el ID de lugar de Google Maps resueltos.
  • Editar coincidencia: Es el botón para abrir el diálogo de propuesta de coincidencia.

4. JSON sin procesar

Proporciona un visor de código interactivo con números de línea y resaltado de sintaxis que muestra la carga útil de JSON analizada completa (item_proto) para una depuración y verificación rápidas del esquema. Los valores de los datos que se presentan aquí reflejarán los valores recibidos del feed de lugares de interés.

Flujo de trabajo de problemas y clasificación

Las entidades marcadas con problemas se inhabilitan (si se marcan con un ERROR) o se degradan (si se marcan con una ADVERTENCIA). Los problemas de entidad con una advertencia no se pueden apelar, y las advertencias se pueden resolver solucionando el problema subyacente.

Tipos de problemas: Apelables y no apelables

  1. Problemas no apelables (validaciones técnicas, de calidad de los datos y de advertencias):
    • Se produce por errores de esquema, campos obligatorios faltantes, coordenadas no válidas, URLs rotas, IDs duplicados o advertencias de contenido no bloqueantes (como nombres de empresas en idiomas que no son los predeterminados o cualquier idioma para las descripciones, las direcciones visibles y las categorías de establecimientos).
    • Resolución: Los socios deben corregir los datos subyacentes en su feed de origen y subir un archivo de feed actualizado.
  2. Problemas apelables (bloqueo de contenido e incumplimientos de políticas):
    • Se activa cuando los recursos de imagen o texto de la propiedad obligatoria no pasan los filtros de seguridad de contenido automatizados con una gravedad de ERROR.
    • Resolución: Si el contenido cumple con las políticas de la plataforma, los socios pueden hacer clic en el botón Apelar junto al problema en el Centro de acciones para enviar una apelación. Los socios deben proporcionar un motivo y una justificación, y nuestro equipo de apelaciones revisará y aprobará o rechazará las solicitudes. Recibirás una notificación por correo electrónico y a través de la herramienta sobre las decisiones que se tomen.

Catálogo de problemas de la unidad de agregador local

En la siguiente tabla, se describe el conjunto completo de errores de validación y códigos de problemas relacionados con las políticas para las integraciones de unidades de agregadores locales:

Descripción del problema Gravedad Código del problema Campo o argumentos afectados ¿Se puede apelar? Acción o política pertinente
Falta el ID del lugar de interés ERROR MISSING_REQUIRED_FIELD poi_id No Proporciona un poi_id único. Consulta las especificaciones del feed de lugares de interés.
Falta la configuración regional predeterminada para el campo "name" ERROR MISSING_REQUIRED_FIELD name.default_locale No Especifica un código de idioma BCP 47 válido para la configuración regional predeterminada. Consulta Compatibilidad multilingüe.
No se encontró ninguna localización predeterminada para el campo "name" ERROR MISSING_REQUIRED_FIELD name.localizations No Proporciona un valor para el nombre localizado del lugar de interés que coincida con el idioma default_locale declarado.
Falta la configuración regional predeterminada para el campo "description" ERROR MISSING_REQUIRED_FIELD description.default_locale No Especifica una configuración regional predeterminada válida de BCP 47 para la descripción de la propiedad.
No se encontró ninguna localización predeterminada para el campo "description" ERROR MISSING_REQUIRED_FIELD description.localizations No Proporciona un texto de descripción que coincida con el idioma default_locale declarado.
Falta la configuración regional predeterminada para el campo "display_address" ERROR MISSING_REQUIRED_FIELD display_address.default_locale No Especifica una configuración regional predeterminada válida de BCP 47 para la dirección visible.
No se encontró ninguna localización predeterminada para el campo "display_address" ERROR MISSING_REQUIRED_FIELD display_address.localizations No Proporciona el texto de la dirección con formato que coincida con el idioma default_locale declarado.
Se superó la cantidad máxima de imágenes WARNING EXCEEDED_MAX_COUNT images No Limita las entradas de imágenes a un máximo de 5 por lugar de interés. Se descartan las imágenes sobrantes.
Coordenada de latitud no válida ERROR INVALID_LATLNG location.latitude No Ingresa una latitud válida entre -90.0 y +90.0. Consulta Definición de coordenadas geográficas.
Coordenada de longitud no válida ERROR INVALID_LATLNG location.longitude No Ingresa una longitud válida entre -180.0 y +180.0. Consulta Definición de coordenadas geográficas.
Falta la coordenada de latitud ERROR MISSING_REQUIRED_FIELD location.latitude No Proporciona el valor de latitud para completar el par de coordenadas. Consulta Definición de coordenadas geográficas.
Falta la coordenada de longitud ERROR MISSING_REQUIRED_FIELD location.longitude No Proporciona el valor de longitud para completar el par de coordenadas. Consulta Definición de coordenadas geográficas.
Dirección faltante o no estructurada ERROR MISSING_REQUIRED_FIELD location.address No Proporciona una dirección postal estructurada que incluya la calle, la localidad, el código postal y el país.
URL con formato incorrecto o no válida ERROR INVALID_ATTRIBUTE_VALUE url No Asegúrate de que la URL de la página de destino use un protocolo HTTP/HTTPS compatible y una sintaxis válida.
Imagen no válida o inaccesible WARNING INVALID_IMAGE image.url No Verifica que se pueda acceder públicamente a las URLs de las imágenes y que no requieran autenticación ni devuelvan errores 4xx o 5xx.
ID de lugar de interés duplicado ERROR DUPLICATE_ENTITY poi_id No Asegúrate de que cada poi_id sea único en la carga útil del feed. Quita las entradas duplicadas.
Entidad coincidente duplicada ERROR DUPLICATE_MATCHED_ENTITY POI No Quita las entradas duplicadas de tu feed o usa la herramienta de coincidencia de entidades de lugar de interés para hacer coincidir las distintas empresas con sus fichas independientes de Google Maps.
Entidad sin coincidencias ERROR UNMATCHED_ENTITY POI No Haz coincidir el lugar de interés con una ficha de lugar de Google Maps con la herramienta Coincidencia de entidades de lugares de interés.
Incumplimiento de la política de imágenes ERROR SAFE_SEARCH_POLICY_VIOLATION_IMAGE image Sí Quita o reemplaza la imagen marcada, o bien haz clic en Apelar para enviar una justificación. Consulta la Política de imágenes de contenido de la Búsqueda de Google.
Incumplimiento de política de texto: Nombre predeterminado ERROR SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Sí Quita o reemplaza el texto del nombre marcado, o bien haz clic en Apelar. Consulta la política de contenido de texto de la Búsqueda de Google.
Incumplimiento de política de texto: Nombre no predeterminado WARNING SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text No Quita o reemplaza el texto del nombre marcado. Consulta la política de contenido de texto de la Búsqueda de Google.
Incumplimiento de política de texto: Descripción WARNING SAFE_SEARCH_POLICY_VIOLATION_TEXT description.localizations.*.text No Quita o reemplaza el texto de la descripción marcado. Consulta la política de contenido de texto de la Búsqueda de Google.
Incumplimiento de política de texto: Dirección visible WARNING SAFE_SEARCH_POLICY_VIOLATION_TEXT display_address.localizations.*.text No Quita o reemplaza el texto de la dirección visible marcado. Consulta la política de contenido de texto de la Búsqueda de Google.
Falta la configuración regional predeterminada para la categoría de establecimiento ERROR MISSING_REQUIRED_FIELD local_data.establishment_category.default_locale No Proporciona un valor para la categoría de establecimiento localizada del lugar de interés que coincida con el idioma default_locale declarado.
Falta el día de apertura en el horario de atención ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_day No Proporciona un día de apertura válido para el horario de atención.
Falta la hora de apertura del horario de atención ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_time No Proporciona un horario de atención válido.
Falta el día de cierre del horario de atención ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_day No Proporciona un día de cierre válido para el horario de atención.
Falta la hora de cierre del horario de atención ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_time No Proporciona una hora de cierre válida para el horario de atención.
La hora de apertura del horario de atención es posterior a la hora de cierre ERROR NOT_LESS_THAN_FIELD local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time No Proporciona un par válido de horarios de apertura y cierre, y asegúrate de que el horario de apertura sea anterior al de cierre.
El valor mínimo del intervalo de precios es mayor que el valor máximo ERROR INVALID_PRICE_RANGE local_data.price_range.min_price, local_data.price_range.max_price No Proporciona un intervalo de precios válido, en el que el precio mínimo sea inferior al precio máximo.
Falta el ID de la marca ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.brand_id No Proporciona un ID de marca válido.
ID de marca duplicado en un lugar de interés ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.brand_id No Asegúrate de que cada brand_id sea único en la carga útil del lugar de interés. Quita las entradas duplicadas.
Falta la URL predeterminada de la marca ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.default_url No Proporciona una URL predeterminada válida de la marca.
URL de la marca no válida o con formato incorrecto ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.default_url No Asegúrate de que la URL predeterminada de la marca use un protocolo HTTP/HTTPS compatible y una sintaxis válida.
Falta la URL de la página de destino localizada de la marca ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.url No Proporciona una URL válida para la página de destino localizada.
La URL de la página de destino localizada de la marca tiene un formato incorrecto o no es válida ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.localized_landing_pages.url No Asegúrate de que la URL de la página de destino localizada use un protocolo HTTP o HTTPS compatible y una sintaxis válida.
URL de página de destino localizada de la marca duplicada ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.url No Asegúrate de que cada url sea único en las páginas de destino localizadas del PDI. Quita las entradas duplicadas.
Falta la configuración regional de la página de destino localizada de la marca ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.locales No Proporciona un conjunto válido de configuraciones regionales para la página de destino localizada.
Configuración regional de la página de destino localizada de la marca duplicada ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.locales No Asegúrate de que cada locale sea único en las páginas de destino localizadas del PDI. Quita las entradas duplicadas.
Incumplimiento de política de texto: Categoría del establecimiento WARNING SAFE_SEARCH_POLICY_VIOLATION_TEXT local_data.establishment_category.localizations.*.text No Quita o reemplaza el texto marcado de la categoría del establecimiento. Consulta la política de contenido de texto de la Búsqueda de Google.

Códigos de problemas

En las siguientes secciones, se proporcionan causas detalladas y pasos de solución para cada código de problema.

Falta completar un campo obligatorio

Código del problema: MISSING_REQUIRED_FIELD
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando tu feed de lugares de interés)

Este error se produce cuando a una entidad transferida le faltan uno o más atributos obligatorios que se requieren en la especificación del feed de lugares de interés.

Consulta el panel Detalles del problema para identificar qué propiedad específica falta y, luego, aplica la corrección correspondiente:

1. Falta el ID del lugar de interés (poi_id)

  • Causa: El campo poi_id está vacío, es nulo o falta en el objeto de entidad raíz.
  • Solución: Proporciona un identificador de cadena único y persistente para la propiedad.
{
  "poi_id": "test_restaurant_1"
}

2. Falta la configuración regional predeterminada o el nombre localizado (name)

  • Causa: Al objeto name le falta la cadena default_locale o el array localizations con una configuración regional coincidente.
  • Solución: Proporciona la entrada default_locale y, al menos, una entrada de localización que coincida con esa configuración regional.
{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Falta la configuración regional predeterminada o la dirección localizada (display_address)

  • Causa: Al objeto display_address le falta la cadena default_locale o el array localizations.
  • Solución: Proporciona el default_locale y, al menos, una entrada de localización que coincida con esa configuración regional para la dirección con formato.
{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Falta la configuración regional predeterminada o la descripción localizada (description)

  • Causa: Cuando se incluye el objeto description, falta default_locale o la localización coincidente.
  • Solución: Proporciona el default_locale y, al menos, una entrada de localización que coincida con esa configuración regional para la descripción.
{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Faltan coordenadas geográficas (location.latitude / location.longitude)

  • Causa: Al objeto location le falta el valor numérico latitude o longitude.
  • Solución: Proporciona latitude y longitude como números de punto flotante en grados decimales estándar de WGS84.
{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Falta la dirección postal estructurada (location.address)

  • Causa: Al objeto location.address le faltan componentes de dirección obligatorios (country, locality o postal_code).
  • Solución: Completa el objeto de dirección postal estructurada según los estándares ISO.
{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Falta la configuración regional predeterminada para la categoría de establecimiento (local_data.establishment_category.default_locale)

  • Causa: El objeto local_data.establishment_category está presente, pero falta default_locale, está vacío o no coincide con ninguna entrada del array localizations.
  • Solución: Especifica una etiqueta de idioma BCP 47 válida para default_locale y proporciona, al menos, una cadena localizada que coincida con esa configuración regional.
{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Falta el día de apertura en el horario de atención (local_data.business_hours.time_ranges.open_day)

  • Causa: Falta una entrada en local_data.business_hours.time_ranges open_day o se estableció en DAY_OF_WEEK_UNSPECIFIED.
  • Solución: Proporciona una cadena de día de la semana válida (p. ej., "MONDAY", "TUESDAY", etcétera).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. Falta la hora de apertura del horario de atención (local_data.business_hours.time_ranges.open_time)

  • Causa: Falta el objeto open_time en una entrada de local_data.business_hours.time_ranges.
  • Corrección: Especifica open_time con hours (0-23) y minutes (0-59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. Falta el día de cierre del horario de atención (local_data.business_hours.time_ranges.close_day)

  • Causa: Falta una entrada en local_data.business_hours.time_ranges close_day o se estableció en DAY_OF_WEEK_UNSPECIFIED.
  • Solución: Proporciona una cadena de día de la semana válida (p. ej., "MONDAY", "TUESDAY", etcétera).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. Falta la hora de cierre del horario de atención (local_data.business_hours.time_ranges.close_time)

  • Causa: Falta el objeto close_time en una entrada de local_data.business_hours.time_ranges.
  • Corrección: Especifica close_time con hours (0-23) y minutes (0-59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. Falta el ID de la marca (local_data.brand_landing_pages.brand_id)

  • Causa: Una entrada en local_data.brand_landing_pages tiene un brand_id vacío, nulo o faltante.
  • Solución: Proporciona un identificador de cadena no vacío que coincida con la configuración de la marca de socio registrada.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. Falta la URL predeterminada de la marca (local_data.brand_landing_pages.default_url)

  • Causa: Falta una entrada en local_data.brand_landing_pages default_url o es una cadena vacía.
  • Solución: Proporciona una URL de página de destino HTTP/HTTPS de resguardo válida para los usuarios cuya configuración regional no coincida con las URLs localizadas.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. Falta la URL de la página de destino localizada de la marca (local_data.brand_landing_pages.localized_landing_pages.url)

  • Causa: Un elemento dentro de localized_landing_pages tiene un campo url faltante o vacío.
  • Solución: Proporciona una URL HTTP o HTTPS válida y completamente calificada para la página de destino localizada.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. Falta la configuración regional de la página de destino localizada de la marca (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Causa: Un elemento dentro de localized_landing_pages tiene un array locales faltante o vacío.
  • Solución: Proporciona al menos un código de idioma o configuración regional BCP 47 válido (p.ej., ["en-US"]) en el array locales.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

Se superó la cantidad máxima de imágenes

Código del problema: EXCEEDED_MAX_COUNT
Gravedad: Advertencia
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando una carga útil de entidad de lugar de interés contiene más de 5 objetos de imagen en el array images.

Corrección:

  • Recorta el array images para que contenga, como máximo, 5 fotos representativas y de alta calidad de la propiedad local.
  • Se descartarán las imágenes que superen el límite de 5.

Coordenadas geográficas no válidas

Código del problema: INVALID_LATLNG
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando las coordenadas geográficas proporcionadas en location.latitude o location.longitude quedan fuera de los límites esféricos válidos o representan coordenadas nulas sin completar.

Causas comunes y corrección:

  • Latitud fuera de los límites: La latitud debe ser un número de punto flotante entre -90.0 y 90.0, inclusive.
  • Longitud fuera de los límites: La longitud debe ser un número de punto flotante entre -180.0 y 180.0, inclusive.
  • Null Island (0,0): El envío de 0.0, 0.0 o números enteros de marcador de posición (como 999, 999) activa el rechazo de coordenadas.
  • Coordenadas intercambiadas: Verifica que la latitud y la longitud no estén invertidas en tu canalización de serialización.

Ejemplo de carga útil válida:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

La URL tiene un formato incorrecto o no es válida

Código del problema: INVALID_ATTRIBUTE_VALUE
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando un valor de atributo no supera la validación del esquema, con mayor frecuencia cuando la URL de la página de destino o de la imagen de un socio no es válida sintácticamente.

Requisitos:

  • Protocolo: Las URLs deben especificar de forma explícita http:// o https:// (se recomienda HTTPS).
  • Codificación: Las URLs que contienen caracteres especiales, espacios o caracteres que no son ASCII deben estar codificadas correctamente con porcentajes (RFC 3986).
  • Dominio canónico: Asegúrate de que el dominio esté completamente calificado (por ejemplo, https://example.com/local/123, no example.com/local/123 ni www.example).

Ejemplo de carga útil válida:

{
  "url": "https://www.tastybitestest.com/en"
}

Imagen no válida o inaccesible

Código del problema: INVALID_IMAGE
Gravedad: Advertencia
Apelable: No (se resuelve actualizando la carga útil del feed)

Esta advertencia se produce durante la etapa de recuperación asíncrona de imágenes, cuando el rastreador de Google no puede descargar, decodificar ni verificar el recurso multimedia de image.url. Si bien se omite la imagen no válida, la propiedad sigue siendo apta para publicarse.

Causas comunes y corrección:

  • Errores de HTTP (404 / 403 / 500): La URL de la imagen devuelve un código de estado HTTP que no es 200. Asegúrate de que se pueda acceder públicamente a las imágenes sin autenticación, muros de cookies ni restricciones de listas de IPs permitidas.
  • Bloqueo de robots.txt: Asegúrate de que tu red de distribución de contenidos (CDN) permita los usuarios-agentes Googlebot y Googlebot-Image.
  • Formato de archivo no compatible: Las imágenes deben estar en formatos de trama estándar (JPEG, PNG, WebP). No se admiten los GIFs animados, los SVGs ni los formatos de cámara sin procesar. Consulta nuestros lineamientos para imágenes para obtener más detalles.
  • Fallas del certificado SSL: Verifica que el servidor de hosting de imágenes tenga una cadena de certificados SSL válida.

ID de lugar de interés duplicado

Código del problema: DUPLICATE_ENTITY
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando la misma cadena poi_id aparece más de una vez en un solo conjunto de archivos de feed.

Corrección:

  • Asegúrate de que cada ficha local de tu feed tenga un poi_id único y determinístico.
  • Si una propiedad local tiene varios tipos de habitaciones o tarifas, consolídalos en una sola entidad de lugar de interés raíz en lugar de emitir registros de entidades duplicados con IDs idénticos.

Entidad coincidente duplicada

Código del problema: DUPLICATE_MATCHED_ENTITY
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed o usando las herramientas de coincidencia de entidades de lugar de interés)

Este error se produce cuando dos o más entradas poi_id distintas de tu feed coinciden con la misma ficha canónica de lugar de Google Maps. Cuando varias empresas se asignan a la misma entidad de Google, se bloquea la publicación de todas las entradas en conflicto hasta que se resuelva la duplicación.

Cómo resolverlo:

  1. Identifica las propiedades en conflicto: Abre el Visualizador de transferencias (Transferencia > Historial), selecciona la ejecución de transferencia más reciente y expande el panel Validaciones. Haz clic en la fila DUPLICATE_MATCHED_ENTITY que comparte el mismo identificador de grupo de Información del problema para ver todos los registros de poi_id que coincidieron con la misma entidad de Google.
  2. Quita las fichas duplicadas de tu feed: Si las entradas de poi_id en conflicto representan la misma ubicación física de la empresa, quita las entradas duplicadas de tu feed para que solo se envíe un poi_id para ese establecimiento.
  3. Ajusta las coincidencias incorrectas para las empresas independientes: Si las entradas de poi_id en conflicto representan empresas independientes y separadas que se vincularon de forma incorrecta con la misma entidad de Google, abre la empresa vinculada de forma incorrecta en la vista de inventario y haz clic en Editar coincidencia para seleccionar o proponer la ficha de lugar de Google Maps dedicada. Puedes encontrar instrucciones detalladas en la guía de coincidencia de entidades de lugares de interés.

Entidad no coincidente

Código del problema: UNMATCHED_ENTITY
Gravedad: Error (bloquea la publicación)
Apelable: No (usa las herramientas de coincidencia de entidades de lugares de interés o corrige los metadatos de la entidad)

Este problema indica que la canalización de coincidencias de Google no pudo conciliar tu ficha local con un lugar canónico en Google Maps.

Cómo resolverlo:

  1. Verifica los atributos principales: Asegúrate de que los atributos name, display_address, location.address, url, telephone y location.latitude/location.longitude de la ubicación reflejen con precisión la ubicación física de la propiedad.
  2. Inspecciona la información de coincidencias: Consulta la columna Match Info en la vista de inventario para ver los lugares candidatos.
  3. Usa la herramienta POI Match Fix Tool: Haz clic en Editar coincidencia en Actions Center para buscar y confirmar manualmente el ID de lugar de Google correcto. Encontrarás instrucciones detalladas en la guía de coincidencia de entidades de PDI.

Incumplimiento de la política de imágenes de la Búsqueda de Google

Código del problema: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Gravedad: ERROR (bloquea la publicación)
Se puede apelar: Sí

Consulta los códigos de problemas relacionados con las políticas aquí: Política de imágenes del contenido de la Búsqueda de Google Política

Si crees que la imagen se marcó por error (falso positivo), haz clic en Crear apelación en el panel Detalles del problema.

Incumplimiento de la política de texto del contenido de la Búsqueda de Google: Nombre

Código del problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravedad: La gravedad varía según el campo (consulta los siguientes detalles)
Campo afectado: name.localizations.*.text
Apelable: Sí (solo ERROR de configuración regional predeterminada); No (advertencia de configuración regional no predeterminada)

  • Configuración regional predeterminada (name.default_locale): ERROR (bloquea la publicación). Se bloquea la publicación de todo el POI. Si crees que el texto del nombre de la configuración regional predeterminada se marcó por error (falso positivo), haz clic en Crear apelación en el panel Detalles del problema.
  • Configuración regional no predeterminada: Advertencia (no bloquea la publicación). Solo se omite la localización marcada, mientras que el lugar de interés sigue siendo apto para publicarse. Las advertencias sobre idiomas que no son predeterminados no se pueden apelar y se pueden resolver actualizando la carga útil del feed.

Consulta los códigos de problemas relacionados con las políticas aquí: Política de contenido de texto de la Búsqueda de Google

Incumplimiento de la política de contenido de texto de la Búsqueda de Google: Descripción

Código del problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravedad: Advertencia (no bloquea la publicación)
Campo afectado: description.localizations.*.text
Apelable: No (se resuelve actualizando la carga útil del feed)

Esta advertencia se produce cuando se marca el texto de description.localizations por incumplir la política de texto del contenido de la Búsqueda de Google. Mientras se omite la localización de la descripción marcada (o todo el campo description si se marca la configuración regional predeterminada), el lugar de interés sigue siendo apto para publicarse.

Consulta los códigos de problemas relacionados con las políticas aquí: Política de contenido de texto de la Búsqueda de Google

Incumplimiento de la política de contenido de texto de la Búsqueda de Google: Dirección visible

Código del problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravedad: Advertencia (no bloquea la publicación)
Campo afectado: display_address.localizations.*.text
Apelable: No (se resuelve actualizando la carga útil del feed)

Esta advertencia se produce cuando el texto de la dirección con formato en display_address.localizations incluye contenido prohibido en la política de texto de contenido de la Búsqueda de Google. Si bien se omite la localización de la dirección marcada (o todo el campo display_address si se marca la configuración regional predeterminada), el lugar de interés sigue siendo apto para publicarse.

Consulta los códigos de problemas relacionados con las políticas aquí: Política de contenido de texto de la Búsqueda de Google

La hora de apertura del horario de atención es posterior a la hora de cierre

Código del problema: NOT_LESS_THAN_FIELD
Gravedad: Error (bloquea la publicación)
Campos afectados: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando el horario de atención open_time es posterior o igual a close_time para el mismo día.

Causas comunes y corrección:

  • Inversión en el mismo día: Asegúrate de que open_time sea anterior a close_time (p.ej., de 09:00 a 17:00).
  • Turnos nocturnos: Si un establecimiento abre un día y cierra después de la medianoche del día siguiente (p.ej., de 21:00 a 02:00), establece close_day en el día siguiente (p.ej., open_day: "FRIDAY", close_day: "SATURDAY").

Ejemplo de carga útil válida:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

El valor mínimo del intervalo de precios es mayor que el valor máximo

Código del problema: INVALID_PRICE_RANGE
Gravedad: Error (bloquea la publicación)
Campos afectados: local_data.price_range.min_price, local_data.price_range.max_price
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando el valor de min_price supera el de max_price, o si min_price y max_price especifican códigos de moneda diferentes.

Causas comunes y corrección:

  • Valores invertidos: Asegúrate de que min_price sea menor o igual que max_price.
  • Discrepancia de moneda: Verifica que min_price.currency_code y max_price.currency_code coincidan con el mismo código de moneda de tres letras ISO 4217 (p.ej., "USD").

Ejemplo de carga útil válida:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Propiedad única duplicada en un lugar de interés

Código del problema: DUPLICATE_UNIQUE_PROPERTY
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)

Este error se produce cuando un campo o un elemento secundario que debe ser único en una entidad de lugar de interés contiene entradas duplicadas.

Consulta el panel Detalles del problema para identificar qué propiedad incumple la unicidad:

1. ID de marca duplicado en un lugar de interés (local_data.brand_landing_pages.brand_id)

  • Causa: Aparece la misma cadena brand_id en varias entradas brand_landing_pages para un solo lugar de interés.
  • Solución: Consolida todas las páginas de destino de esa marca en un solo objeto brand_landing_pages.

Ejemplo de carga útil válida:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. URL de página de destino localizada de la marca duplicada (local_data.brand_landing_pages.localized_landing_pages.url)

  • Causa: Se define exactamente la misma URL de página de destino varias veces en localized_landing_pages para la misma marca.
  • Solución: Asegúrate de que cada entrada de URL sea distinta o asocia varios parámetros de configuración regional en un solo array locales de entrada de URL.

Ejemplo de carga útil válida:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. Configuración regional de la página de destino localizada de la marca duplicada (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Causa: El mismo código de configuración regional (p.ej., "en-US") se repite en varias entradas de localized_landing_pages para la misma marca.
  • Solución: Asigna cada etiqueta de configuración regional a exactamente una página de destino localizada.

Ejemplo de carga útil válida:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

La URL de la marca tiene un formato incorrecto o no es válida

Código del problema: INVALID_ATTRIBUTE_VALUE
Gravedad: Error (bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)
Campos afectados: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Este error se produce cuando una URL predeterminada de la marca o una URL de página de destino localizada no supera la validación de la sintaxis del URI.

Requisitos:

  • Protocolo: Debe especificar de forma explícita http:// o https:// (se requiere https:// para la entrega de producción).
  • Sintaxis: Debe ser una URL válida, codificada en porcentaje y que cumpla con el estándar RFC 3986, con un nombre de dominio completamente calificado.

Ejemplo de carga útil válida:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Incumplimiento de la política de contenido de texto de la Búsqueda de Google: Categoría del establecimiento

Código del problema: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Gravedad: Advertencia (no bloquea la publicación)
Apelable: No (se resuelve actualizando la carga útil del feed)
Campo afectado: local_data.establishment_category.localizations.*.text

Esta advertencia se produce cuando el texto localizado de la categoría del establecimiento no pasa los filtros de contenido automáticos de SafeSearch. Si bien se omite la localización de la categoría de establecimiento marcada (o todo el campo establishment_category si se marca la configuración regional predeterminada), el lugar de interés sigue siendo apto para publicarse.

Corrección:

Ejemplo de carga útil válida:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}
Siguiente
Correlación de entidades de LPI