Puedes usar el recurso productstatuses
para ver el estado detallado de tus productos de Shopping.
Consulta los problemas del producto para obtener detalles de los problemas habituales.
Los comercios son responsables de cumplir con las políticas de anuncios de Shopping y fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y de responder de forma adecuada si encontramos contenido o comportamientos que las infrinjan.
Requisitos
Para ver los estados de los productos, debes hacer lo siguiente:
- Inscribe tu cuenta en un destino.
- Proporciona un código de país válido en uno de los siguientes documentos:
- El campo
feedLabel
- El campo
shipping
- A nivel del feed
- La configuración de envío de tu cuenta.
- El campo
Cómo obtener el estado de un producto
Usa productstatuses.get
para ver el estado de un producto.
Puedes usar el parámetro destinations
en las solicitudes get
y list
para ver los problemas de un destino específico. Si no especificas un destino, se mostrarán los problemas de todos los destinos aptos.
A continuación, se muestra una solicitud de get
de muestra, con parámetros de consulta opcionales:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle
Todas las respuestas de productstatuses.get
incluyen los siguientes campos:
kind
: El valor es siemprecontent#productStatus
.creationDate
: Es la fecha en la que se creó el producto.lastUpdateDate
: Es la última vez que se actualizó el producto.googleExpirationDate
: Es la fecha en la que vence el producto.productId
: Es el ID de REST del producto.title
: Es el título del producto.link
: Es el vínculo de URL del producto.destinationStatuses
: Es el estado del producto en cada destino y país.
Solo verás el campo itemLevelIssues
en la respuesta si el producto tiene problemas a nivel del artículo en el momento de la solicitud.
A continuación, se muestra un ejemplo de una respuesta JSON:
{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "strong_id_inaccurate",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "mpn",
"destination": "Shopping",
"description": "Incorrect product identifier [mpn]",
"detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
"documentation": "https://support.google.com/merchants/answer/160161",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "image_link_internal_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "image link",
"destination": "Shopping",
"description": "Processing failed [image link]",
"detail": "Wait for the product image to be crawled again (up to 3 days)",
"documentation": "https://support.google.com/merchants/answer/6240184",
"applicableCountries": [
"US, UK"
]
},
{
"code": "landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"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",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "missing_condition_microdata",
"servability": "unaffected",
"resolution": "merchant_action",
"destination": "Shopping",
"description": "Missing or invalid data [condition]",
"detail": "Add valid structured data markup to your landing page",
"documentation": "https://support.google.com/merchants/answer/6183460",
"applicableCountries": [
"US", "UK"
]
},
{
"code": "mobile_landing_page_error",
"servability": "disapproved",
"resolution": "merchant_action",
"attributeName": "link",
"destination": "Shopping",
"description": "Unavailable mobile landing page",
"detail": "Update your website or landing page URL to enable access from mobile devices",
"documentation": "https://support.google.com/merchants/answer/6098296",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}
Enumera todos los estados de los productos
Usa productstatuses.list
para ver todos tus productos y sus estados.
Puedes usar los siguientes parámetros para definir mejor tu consulta:
destinations
: Es el destino para el que se ven los estados.pageToken
: Se usa para obtener las siguientes páginas de resultados. Cada página tiene unnextPageToken
que puedes usar para ver la siguiente página de la secuencia.maxResults
: Es la cantidad máxima de resultados por página.
A continuación, se muestra una solicitud de list
de muestra con parámetros de consulta opcionales:
GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9
A continuación, se muestra un ejemplo de una respuesta JSON:
{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
{
"kind": "content#productStatus",
"productId": "online:en:US:online-en-US-GGL614",
"title": "Green Headphones",
"link": "https://example.com/green-headphones/",
"destinationStatuses": [
{
"destination": "Shopping",
"status": "disapproved",
"disapprovedCountries": [
"US", "UK"
]
},
{
"destination": "ShoppingActions",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "disapproved",
"disapprovedCountries": [
"US"
]
}
],
"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",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review",
"servability": "disapproved",
"resolution": "pending_processing",
"destination": "Shopping",
"description": "Pending initial review",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US, UK"
]
},
{
"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",
"applicableCountries": [
"US", "UK"
]
}
],
"creationDate": "2020-01-09T15:36:39Z",
"lastUpdateDate": "2020-01-14T19:17:02Z",
"googleExpirationDate": "2020-02-13T19:17:02Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:43",
"title": "Green shirt",
"link": "https://example.com/shirt-green/",
"destinationStatuses": [
{
"destination": "ShoppingActions",
"status": "approved",
"approvedCountries": [
"US"
]
},
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
},
{
"kind": "content#productStatus",
"productId": "online:en:US:40",
"title": "Black hat",
"link": "https://example.com/hat-black/",
"destinationStatuses": [
{
"destination": "SurfacesAcrossGoogle",
"status": "approved",
"approvedCountries": [
"US"
]
}
],
"creationDate": "2019-01-29T21:14:36Z",
"lastUpdateDate": "2019-02-21T18:47:44Z",
"googleExpirationDate": "2019-03-23T18:47:44Z"
}
]
}
Es seguro probar la llamada a productstatuses.list
en producción porque no realiza ningún cambio en tus datos.
Destinos
Estos son los destinos que puedes usar para los productos de Shopping:
shopping ads
: Indica los productos de anuncios de Shopping.ShoppingActions
: Productos de Comprar con Google.surfaces across google
: Productos de las fichas gratuitas.shopping
: Productos de los anuncios del inventario local.
Problemas a nivel del artículo
Cada problema a nivel del artículo incluye los siguientes campos:
code
: El código de error que se usa para determinar el problemaservability
: Indica si el producto se muestra de la siguiente manera:disapproved
: El problema impide que se muestre el producto.unaffected
: Aún se muestra el producto.
resolution
: Informa si el comercio puede resolver el problema.attributeName
: Es el nombre del atributo afectado.destination
: Es el destino afectado.description
: Es la descripción del producto.detail
: Brinda más información sobre el problema.documentation
: Indica dónde encontrar la documentación sobre el problema.applicableCountries
: Indica en qué países el problema afecta al producto.