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 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 responder adecuadamente si detectamos contenido o comportamiento que las infringe.

Requisitos

Debes hacer lo siguiente para ver los estados de los productos:

  • Inscribe tu cuenta en un destino.
  • Proporciona un código de país válido en una de las siguientes opciones:
    • 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 get y list para ver los problemas de un destino específico. Si no especificas un destino, se mostrarán errores 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 siempre es content#productStatus.
  • creationDate: Es la fecha en la que se creó el producto.
  • lastUpdateDate: Indica 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 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.

Este es un ejemplo de 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 productos

Usa productstatuses.list para ver todos tus productos y sus estados.

Puedes usar los siguientes parámetros para definir mejor tu consulta:

  • destinations: El destino para el que se verán los estados.
  • pageToken: Se usa para obtener páginas de resultados subsiguientes. 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 muestra con parámetros de consulta opcionales:

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

Este es un ejemplo de 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.

Lugares de destino

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

  • shopping ads: Son los productos de los anuncios de Shopping.
  • ShoppingActions: Productos de Comprar con Google.
  • surfaces across google: Son productos que aparecen en las fichas gratuitas.
  • shopping: Son los productos de 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: 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.