Estados del producto

Puedes usar el recurso productstatuses para ver el estado detallado de tus productos de Shopping.

Consulta los problemas del producto para obtener detalles sobre los problemas comunes.

Los comercios son responsables de cumplir con las políticas de los anuncios de Shopping y las fichas gratuitas. Google Shopping se reserva el derecho de aplicar estas políticas y responder según corresponda si detectamos 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 formatos:
    • El campo feedLabel
    • El campo shipping
    • A nivel del feed
    • La configuración de envío de tu cuenta

Obtén el estado de un producto

Usa productstatuses.get para ver el estado de un producto.

Puedes usar el parámetro destinations en las solicitudes de get y list para ver los problemas de un destino específico. Si no especificas un destino, se devuelven los problemas de todos los destinos aptos.

A continuación, se muestra una solicitud de get de ejemplo 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 siempre es content#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 de vencimiento del 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 tu solicitud.

Esta es una respuesta JSON de ejemplo:

{
"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 búsqueda:

  • destinations: Es el destino para el que se verán los estados.
  • pageToken: Se usa para obtener las páginas posteriores de resultados. Cada página tiene un nextPageToken que puedes usar para obtener 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 ejemplo con parámetros de consulta opcionales:

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

Esta es una respuesta JSON de ejemplo:

{
"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 productstatuses.list en producción, ya que no realiza ningún cambio en tus datos.

Destinos

Estos son los destinos que puedes usar para los productos de Shopping:

  • shopping ads: Productos de anuncios de Shopping.
  • ShoppingActions: Productos de Comprar con Google.
  • surfaces across google: Productos de 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: Es el código de error que se usa para determinar el problema.
  • servability: Indica si el producto se muestra de la siguiente manera:
    • disapproved: El problema impide que se muestre el producto.
    • unaffected: El producto sigue mostrándose.
  • resolution: Indica 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: Proporciona 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.