Supongamos que deseas obtener información sobre los productos disponibles actualmente en tu cuenta. En particular, te interesa saber si alguno de tus productos tiene problemas que deben abordarse. Sabes cómo obtener esta información de Merchant Center, pero prefieres configurar un sistema de alertas automático con Content API. En esta guía, analizaremos cómo la información sobre la gravedad del problema en la Content API se correlaciona con la priorización de problemas que se observa en los informes de Diagnóstico de Merchant Center.
Ejemplo con Content API
Para obtener los problemas que afectan tus productos, puedes ejecutar accountstatuses.get para tu cuenta. Este es un ejemplo reducido del recurso que obtienes:
{
"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 la cuenta de Merchant Center. Los errores de Critical provocarán la suspensión de la cuenta, lo que impedirá que publiques tus productos.
En itemLevelIssues, puedes ver los errores del producto que pueden provocar su rechazo. Ten en cuenta que itemLevelIssues[].numItems te informa que 2 artículos de tu cuenta se ven afectados por un vínculo de imagen dañado y que 5 artículos tienen un error en la página de destino.
En itemLevelIssues[].servability, puedes ver si el error provoca el rechazo de los productos afectados. Ten en cuenta que tanto el vínculo de imagen roto como el error de la página de destino hacen que se rechacen los productos.
Para encontrar todos los productos afectados, llama a Productstatuses.list para obtener una lista completa de los problemas por producto. Devuelve 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 qué tan importante es corregirlos.
En nuestro ejemplo de productstatuses, puedes usar itemLevelIssues[].servability para descubrir si un error inhabilita tu capacidad de publicar el producto en Comprar en Google, los anuncios de Shopping o las plataformas de Google.
Si itemLevelIssues[].servability es unaffected, como el error ambiguous_gtin, el error no impedirá que se publique tu producto.
Sin embargo, si itemLevelIssues[].servability es disapproved, como el error mobile_landing_page_crawling_not_allowed, se trata de un error mucho más grave, ya que no podrás publicar tu producto hasta que se corrija.
En nuestro ejemplo de accountstatuses, en accountLevelIssues[].severity, la sección Diagnóstico de Merchant Center define la priorización de los problemas y explica con precisión qué significan las diferentes prioridades.
Primero, consulta el 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? ¿Qué entradas son problemas que debes solucionar lo antes posible y cuáles sería bueno abordar, pero no son esenciales? ¿Qué problemas impedirán que tus productos se publiquen en tus anuncios si no los solucionas?
Como se muestra en estos ejemplos, la sección Diagnóstico proporciona información sobre la gravedad de los problemas de la cuenta y los productos de esa cuenta, mientras que la API de Content (a través del servicio Accountstatuses) proporciona información sobre la gravedad solo para los problemas de accountLevel.
Cada fuente divide los problemas en tres categorías según su gravedad. Comprender cómo juzgar la gravedad de los problemas que devuelven los servicios relacionados con el estado puede ayudar a identificar rápidamente qué problemas son los más importantes para 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 los 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 los errores, 
para las advertencias y 
para las notificaciones.
Los errores provocaron la suspensión de la cuenta o el rechazo de un artículo. Se deben resolver lo antes posible para garantizar que los artículos vuelvan a ser aptos para aparecer en los resultados.
Las advertencias podrían afectar negativamente el rendimiento de tus anuncios y probablemente generen la suspensión de la cuenta o del artículo en el futuro, a menos que se resuelva el problema.
Las notificaciones son sugerencias de optimizaciones para aumentar la calidad de los datos. Se recomienda resolver estos problemas, pero no es obligatorio.
Sin embargo, no es necesario que visites Merchant Center para saber qué errores son cuáles.
En la API de Content, 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 los siguientes 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:
| 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 de missing_ad_words_link te informa que debes vincular una cuenta de Google Ads para publicar anuncios, pero no afectará la aprobación del producto en tu base de datos de Merchant Center.
Por otro lado, el error editorial_and_professional_standards_destination_url_down_policy es más grave y suspende tu cuenta. Si participas en Comprar con Google o en las plataformas de Google, o si tenías una cuenta de Google Ads vinculada, el error critical impide que tus productos se publiquen de inmediato en los programas de Comprar con Google, las plataformas de Google y los anuncios de Shopping.
Con esta información, ahora puedes escribir software de alertas que te avise de inmediato sobre los problemas importantes y recopile los problemas menos graves para su eventual corrección, sin tener que visitar Merchant Center para discernir cuáles son cuáles.