Supongamos que deseas obtener información sobre los productos disponibles en tu cuenta actualmente. En particular, te interesa saber si alguno de tus productos tiene problemas que se deban abordar. Sabes cómo obtener esta información en Merchant Center, pero preferirías configurar un sistema de alertas automáticas mediante Content API. En esta guía, analizaremos cómo la información de gravedad de los problemas en Content API se asigna a la priorización de problemas que se ve en los informes de diagnóstico de Merchant Center.
Ejemplo con Content API
Para obtener los problemas que afectan a tus productos, puedes ejecutar accountstatuses.get en tu cuenta. Este es un ejemplo más breve del recurso que recibes:
{
"kind": "content#accountStatus",
"accountId": "...",
"accountLevelIssues": [
{
"id": "editorial_and_professional_standards_destination_url_down_policy",
"title": "Account suspended due to policy violation: landing page not working",
"country": "US",
"severity": "critical",
"documentation": "https://support.google.com/merchants/answer/6150244#wycd-usefulness"
},
{
"id": "missing_ad_words_link",
"title": "No Google Ads account linked",
"severity": "error",
"documentation": "https://support.google.com/merchants/answer/6159060"
}
],
"products": [
{
"channel": "online",
"destination": "Shopping",
"country": "US",
"statistics": {
"active": "0",
"pending": "0",
"disapproved": "5",
"expiring": "0"
},
"itemLevelIssues": [
{
"code": "image_link_broken",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"description": "Invalid image [image link]",
"detail": "Ensure the image is accessible and uses an accepted image format (JPEG, PNG, GIF)",
"documentation": "https://support.google.com/merchants/answer/6098289",
"numItems": "2"
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"description": "Unavailable desktop landing page",
"detail": "Update your website or landing page URL to enable access from desktop devices",
"documentation": "https://support.google.com/merchants/answer/6098155",
"numItems": "5"
}
]
},
...
}
En accountLevelIssues[].severity, verás la gravedad de los errores de las cuentas de Merchant Center. Los errores Critical provocarán la suspensión de la cuenta, lo cual te impedirá publicar tus productos.
En itemLevelIssues, puedes ver los errores de los productos que pueden generar rechazos de productos. Ten en cuenta que itemLevelIssues[].numItems te permite saber que 2 elementos
de tu cuenta presentan un vínculo de imagen que no funciona y que 5 elementos tienen un
error de página de destino.
En itemLevelIssues[].servability, puedes ver si el error hace que se rechacen los productos afectados. Ten en cuenta que el vínculo de imagen no funciona y el error de la página de destino provocan que se rechacen los productos.
Para encontrar todos los productos afectados, llama a Productstatuses.list a fin de obtener una lista completa de los problemas por producto. Muestra entradas como las siguientes:
{
"kind": "content#productstatusesListResponse",
...
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
...
"itemLevelIssues": [
{
"code": "mobile_landing_page_crawling_not_allowed",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Mobile page not crawlable due to robots.txt",
"detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
"documentation": "https://support.google.com/merchants/answer/6098296"
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694"
},
{
"code": "ambiguous_gtin",
"servability": "unaffected",
"resolution": "merchant_action",
"attributeName": "gtin",
"destination": "Shopping",
"description": "Ambiguous value [gtin]",
"detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
"documentation": "https://support.google.com/merchants/answer/7000891"
}
],
...
},
...
]
}
Ahora tienes información sobre los problemas de todos los productos de tu cuenta, pero no está claro lo importante que es solucionarlos.
En nuestro ejemplo de productstatuses, puedes usar itemLevelIssues[].servability para descubrir si un error inhabilita la publicación del producto en Comprar con Google, los anuncios de Shopping o las plataformas de Google.
Si itemLevelIssues[].servability es unaffected, como el error ambiguous_gtin, este no impedirá que se entregue tu producto.
Sin embargo, si itemLevelIssues[].servability es disapproved como el error mobile_landing_page_crawling_not_allowed, este es un error mucho más grave, ya que no puedes entregar el producto hasta que se corrija el error.
En nuestro ejemplo de accountstatuses, en accountLevelIssues[].severity, la sección Diagnóstico de Merchant Center define la priorización de los problemas y el significado preciso de las diferentes prioridades.
Primero, echa un vistazo al informe:
¿Cómo se correlaciona toda la información que obtienes de Content API for Shopping con lo que ves en la sección Diagnóstico? ¿Cuáles entradas son problemas que debes corregir lo antes posible y cuáles serían problemas, pero no esenciales? ¿Qué problemas impedirán que tus productos se publiquen en tus anuncios si no se abordan?
Como se muestra en estos ejemplos, la sección Diagnóstico proporciona información de gravedad sobre los problemas de la cuenta y los productos en esa cuenta, mientras que Content API (a través del servicio Accountstatuses) proporciona información de gravedad exclusivamente para los problemas de accountLevel.
Cada fuente divide los problemas en tres categorías según su gravedad. Comprender cómo evaluar la gravedad de los problemas que muestran los servicios relacionados con el estado puede ayudar a identificar con rapidez qué problemas son los más importantes de abordar y cuáles se pueden ignorar de forma segura.
Prioridad de los problemas
En la sección Diagnóstico, la priorización de problemas describe la gravedad del problema en uno de estos tres niveles: errores, advertencias y notificaciones. En las tablas de informes como la anterior, estos niveles se representan con imágenes que aparecen en la primera columna: 
para errores, 
para advertencias y 
para notificaciones.
Los errores causaron la suspensión de la cuenta o el rechazo de un artículo. Deben resolverse lo antes posible a fin de garantizar que los elementos sean aptos para volver a aparecer en los resultados.
Las advertencias pueden afectar negativamente el rendimiento de tus anuncios y es probable que provoquen la suspensión de los artículos o las cuentas en el futuro, a menos que se resuelva el problema.
Las notificaciones son optimizaciones sugeridas para aumentar la calidad de los datos. Se recomienda resolver estos problemas, pero no es obligatorio.
Sin embargo, no necesitamos visitar Merchant Center para descubrir cuáles son los errores.
En Content API, el campo accountLevelIssues[].severity de los objetos de recursos accountstatuses proporciona la misma información sobre la gravedad del problema. Estos campos pueden contener uno de tres valores: critical, error y suggestion.
Estos valores tienen una correspondencia uno a uno con la priorización de problemas en la pestaña Diagnóstico (Diagnostics):
| Gravedad del problema de calidad de los datos (API) | Priorización de problemas |
|---|---|
critical |
Error () |
error |
Advertencia () |
suggestion |
Notificación () |
Por lo tanto, en nuestro ejemplo de accountstatuses, el problema missing_ad_words_link te permite saber que necesitas vincular una cuenta de Google Ads para publicar anuncios, pero esto no afectará la aprobación del producto en tu base de datos de Merchant Center.
Por otro lado, editorial_and_professional_standards_destination_url_down_policy es un error más grave que suspende tu cuenta. Si participas en Comprar con Google, las plataformas de Google o si tenías una cuenta de Google Ads vinculada, un error critical impide de inmediato que tus productos se publiquen en los programas Comprar con Google, las plataformas de Google y los anuncios de Shopping.
Con esta información, ahora puedes escribir un software de alerta que te informará los problemas importantes de inmediato mientras recopilas los problemas menos graves para corregirlos en algún momento, sin tener que visitar Merchant Center a fin de determinar cuál es cuál.