Compartir a través de


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.