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 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.

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 siempre 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 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:

Nota: Se actualizaron algunos de los nombres de los destinos de productos (Shopping Actions, Surfaces across Google [plataformas de Google] y locales across Google [plataformas locales de Google]) (ahora pueden ser fichas Comprar con Google, Free listings [fichas gratuitas] y Free local listings [fichas locales gratuitas]). El método productstatuses.get solo muestra los valores anteriores.

{
"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 un nextPageToken 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 problema
• servability: 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.