¿Cómo obtengo el estado de las ofertas de productos?

  • Artículo

Al agregar o actualizar una oferta de producto en un catálogo o almacén, la oferta pasa por una validación inicial antes de pasar por la revisión editorial. Ese proceso puede tardar hasta 36 horas. Para ver si la oferta superó el proceso de revisión, use el recurso Estado .

Nota:

Para obtener una lista de productos que tienen su estado establecido en Desaprobado o Advertencia, consulte Obtención del estado de las ofertas de productos.

A continuación se muestra el URI base que se usa para obtener el Status recurso.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Para obtener el estado de las ofertas de productos, anexe la siguiente plantilla al URI base.

{bmcMerchantId}/catalogs/{catalogId}/status

Establezca {bmcMerchantId} en el identificador de la tienda de BMC y establezca {catalogId} en el identificador del catálogo que contiene las ofertas de producto de las que desea obtener el estado.

Cada solicitud HTTP debe incluir el token de acceso de OAuth del usuario y el token de desarrollador. Para especificar el token de acceso del usuario, establezca el encabezado AuthenticationToken . Para especificar el token de desarrollador, establezca el encabezado DeveloperToken .

Si administra catálogos en nombre de otros clientes, debe establecer lo siguiente:

  • Encabezado CustomerId al identificador de cliente del cliente cuya tienda administra.
  • Encabezado CustomerAccountId al identificador de cuenta de cualquiera de las cuentas del cliente que administre (no importa qué cuenta administrada).

No es necesario especificar el token de acceso o el token de desarrollador para descargar el informe; solo necesita especificarlos para obtener el estado.

De forma predeterminada, Content API usa objetos JSON para representar el estado. Para usar XML, establezca el parámetro de consulta alt en XML.

Envíe una solicitud HTTP GET a la dirección URL resultante. La respuesta contiene un objeto Status que contiene el número de ofertas que pasaron o no pudieron realizar el proceso de revisión en los últimos 30 días. Si se produjo un error en la revisión de una oferta, el Status recurso incluye una dirección URL que puede usar para descargar un informe que describa por qué se produjo un error en la oferta.

A continuación se muestra un objeto de ejemplo Status .

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

El informe identifica la oferta que produjo un error, pero no proporciona la información de control de versiones o marca de tiempo que puede usar para identificar a qué actualizaciones hace referencia el informe. Por ejemplo, si cargó una oferta hace 2 días y la actualizó ayer, no sabrá si el problema está relacionado con la versión cargada hace 2 días o con la que se cargó ayer. Sin embargo, es posible que pueda usar los atributos del elemento en la columna Fragmento de código de oferta del informe para deducir qué versión del elemento se notifica.

Dado que el archivo de informe está comprimido con ZIP, debe descomprimir el archivo para leer el informe. No hay ningún límite en el número de informes que el sistema puede almacenar; sin embargo, el período de tiempo que se almacenan los informes no está definido. Para obtener información sobre el contenido del informe, vea Formato de informe.

En función de la actividad asociada al catálogo, el informe puede ser grande. No debe solicitar el informe con más frecuencia de lo necesario. El intervalo recomendado no es superior a una vez por hora.

Para obtener un ejemplo de código que muestra cómo obtener el estado del catálogo y descargar el informe, consulte Descarga del informe de estado del catálogo.

A continuación se muestra un informe de ejemplo.

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"