Recurso de estado

El recurso Estado le permite obtener el estado de las ofertas de productos que cargó en el catálogo especificado. Después de cargar ofertas en el catálogo, pasan por un proceso de validación y revisión editorial. Este proceso puede tardar hasta 36 horas. La oferta se incluye en el informe solo después de completar el proceso de revisión.

Para obtener información general sobre cómo funciona el proceso, consulte ¿Cómo obtengo el estado de las ofertas de productos?

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.

Base URI

El siguiente es el URI base al que anexa las plantillas.

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

Plantillas

Para crear los puntos de conexión usados para obtener el estado de las ofertas de productos en un catálogo, anexe la plantilla adecuada al URI base.

Nota:

{bmcMerchantId}/catalogs/{catalogId}/status ha quedado en desuso y no se recomienda usarlo.

Plantilla	Verbo HTTP	Descripción	Recurso
{bmcMerchantId}/catalogs/{catalogId}/status	GET	Use para obtener el número de ofertas cargadas que pasaron o no validaron y revisaron editorialmente. Establézcalo {bmcMerchantId} en el identificador de almacén de MMC. Establezca {catalogId} en el identificador del catálogo.	Solicitud: N/A Respuesta: Estado

Parámetros de consulta

Los puntos de conexión pueden incluir los siguientes parámetros de consulta.

Parámetro	Descripción
alt	Opcional. Use para especificar el tipo de contenido que se usa en la solicitud y la respuesta. Los valores posibles son json y xml. El valor predeterminado es json.

Encabezados

A continuación se muestran los encabezados de solicitud y respuesta.

Encabezado	Descripción
Aceptar	Encabezado de solicitud.<p>Incluya este encabezado al descargar el informe. Debe establecer este encabezado en application/x-zip-compressed.
AuthenticationToken	Encabezado de solicitud. Establezca este encabezado en un token de autenticación de OAuth. Para obtener información sobre cómo obtener un token, consulte Autenticación de las credenciales.
Ubicación del contenido	Encabezado de respuesta. Dirección URL que identifica el almacén en el que se insertó el producto. Este encabezado se incluye en la respuesta de una solicitud Insert.
CustomerAccountId	Encabezado de solicitud. Identificador de cuenta de cualquiera de las cuentas que administra en nombre del cliente especificado en el CustomerId encabezado. No importa qué cuenta especifique. Especifique este encabezado solo si administra una cuenta en nombre del cliente.
Customerid	Encabezado de solicitud. El identificador de cliente del cliente cuya tienda administra. Especifique este encabezado solo si administra la tienda en nombre del cliente. Si establece este encabezado, también debe establecer el CustomerAccountId encabezado.
DeveloperToken	Encabezado de solicitud. Token de acceso de desarrollador de la aplicación cliente. Cada solicitud debe incluir este encabezado. Para obtener información sobre cómo obtener un token, consulte ¿Tiene sus credenciales de Microsoft Advertising y el token de desarrollador?
Ubicación	Encabezado de respuesta. Dirección URL que identifica el almacén en el que se insertó el producto. Este encabezado se incluye en la respuesta de una solicitud Insert.
WebRequestActivityId	Encabezado de respuesta. Identificador de la entrada de registro que contiene los detalles sobre la solicitud. Siempre debe capturar este identificador si se produce un error. Si no puede determinar y resolver el problema, incluya este identificador junto con la otra información que proporcione al equipo de soporte técnico.

Objetos de solicitud y respuesta

A continuación se muestran los objetos de solicitud y respuesta que usa la API.

Cada objeto define el nombre de clave JSON y el nombre del elemento XML que se usan en función del tipo de contenido especificado para la solicitud.

Objeto	Descripción
Estado	Define el estado de las ofertas de productos que se cargaron en el catálogo.

Estado

Define el estado de las ofertas de productos que se cargaron en el catálogo. El nombre XML del objeto es <catalogStatus>.

Nombre	Valor	Tipo	Nombre del elemento XML
catalogId	Identificador del catálogo que se va a notificar.	Ulong	<catalog_id>
publishedCount	El número de ofertas que pasaron la validación y la revisión editorial.	Ulong	<published_count>
rejectedCount	El número de ofertas que no pudieron validarse y revisar editorialmente. Este recuento indica el número de filas en el cuerpo del informe (consulte Formato de informe).	Ulong	<rejected_count>
rejectionReportUrl	Dirección URL que se usa para descargar el informe. El objeto incluye este campo solo cuando rejectedCount es mayor que cero. El informe se comprime y se debe descomprimir para poder leerlo.	string	<catalog_id>

Códigos de estado HTTP

Las solicitudes pueden devolver los siguientes códigos de estado HTTP.

Código de estado	Descripción
200	Correcto.
400	Solicitud incorrecta. Un valor de parámetro de consulta no es válido o la dirección URL del informe (vea rejectionReportUrl) ya no es válida.
401	No autorizado. Las credenciales del usuario no son válidas.
404	No encontrado. El estado no está disponible para el catálogo especificado o el identificador de catálogo o almacén no es válido.
500	Error del servidor.

Formato de informe

El archivo de informe que descargue se encuentra en una carpeta comprimida zip (*.zip). Debe descomprimir la carpeta y su contenido para poder leer el informe. El informe es un archivo delimitado por comas denominado MerchantCatalogReport.csv.

El informe se divide en una sección de encabezado y una sección del cuerpo del informe. La primera fila contiene los siguientes nombres de columna para la sección de encabezado.

Nombre de columna	Descripción
Nombre del catálogo	Nombre del catálogo.
Id. de catálogo	Identificador del catálogo.
Id. de tienda	Identificador del almacén que contiene el catálogo.
Tiempo de carga	No usar. Si este campo existe, omita este campo.

La segunda fila contiene los datos de encabezado.

La tercera fila está en blanco.

La cuarta fila contiene los siguientes nombres de columna para el cuerpo del informe, que comienza en la quinta fila.

Nombre de columna	Descripción
Id. de elemento	OfferId de la oferta que no pudo validarse o revisar editorialmente. El informe contendrá identificadores únicos.
Mensaje	Error que se está notificando.
Tipo	Tipo de error. Los valores posibles son Error o Advertencia.
Valores	Valor de datos que produjo el error, si el error fue causado por un valor no válido.
Fragmento de código de oferta	Una lista delimitada por punto y coma del subconjunto de los datos de la oferta. El formato es title; productType; vínculo; imageLink; precio; salePrice; saleStartDate; saleEndDate. No todos los errores incluirán todos los componentes.

Para obtener un ejemplo del informe, vea Informe de ejemplo.