Administración de los catálogos
Content API es una API RESTful que usa el recurso Catálogos para administrar catálogos en el almacén de Microsoft Merchant Center (MMC).
A continuación se muestra el URI base que se usa para llamar a Content API.
https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/
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).
De forma predeterminada, Content API usa objetos JSON para representar los catálogos. Para usar XML, establezca el parámetro de consulta alt en XML.
Para obtener más información sobre el uso del recurso Catálogos, consulte las secciones siguientes.
- Obtención de un catálogo de la tienda
- Obtención de la lista de catálogos de la tienda
- Eliminación de un catálogo del almacén
- Adición de un catálogo al almacén
- Actualización de un catálogo en el almacén
Para obtener un ejemplo de código que muestra cómo obtener, agregar, actualizar y eliminar catálogos, vea Ejemplo de código De administración de catálogos.
Obtención de un catálogo de la tienda
Para obtener un catálogo del almacén, anexe la siguiente plantilla al URI base.
{bmcMerchantId}/catalogs/{catalogId}
Establezca {bmcMerchantId} en el identificador de la tienda MMC y establezca {catalogId} en el identificador del catálogo.
Envíe una solicitud HTTP GET a la dirección URL resultante. Si se encontró el catálogo, la respuesta contiene un objeto Catalog que contiene los detalles del catálogo.
Obtención de una lista de catálogos de la tienda
Para obtener una lista de catálogos del almacén, anexe la siguiente plantilla al URI base.
{bmcMerchantId}/catalogs
Establezca en {bmcMerchantId} el identificador de la tienda MMC.
Envíe una solicitud HTTP GET a la dirección URL resultante. Si el almacén contiene catálogos, la respuesta contiene un objeto Catalogs que contiene la lista de catálogos.
Eliminación de un catálogo del almacén
Para eliminar un catálogo del almacén, anexe la siguiente plantilla al URI base.
{bmcMerchantId}/catalogs/{catalogId}
Establezca {bmcMerchantId} en el identificador de la tienda MMC y establezca {catalogId} en el identificador del catálogo.
Envíe una solicitud HTTP DELETE a la dirección URL resultante. Si se encontró el catálogo, se elimina.
Adición de un catálogo al almacén
Los catálogos se usan para agrupar lógicamente los productos. Para agregar un catálogo al almacén, anexe la plantilla siguiente al URI base.
{bmcMerchantId}/catalogs
Establezca en {bmcMerchantId} el identificador de la tienda MMC.
Envíe una solicitud HTTP POST a la dirección URL resultante. Si se agrega el catálogo, la respuesta contiene un objeto Catalog . El Catalog objeto incluye el identificador del catálogo. Use el identificador para obtener y eliminar el catálogo.
El cuerpo de la solicitud es un objeto Catalog . Debe especificar los campos siguientes.
El nombre que especifique debe ser único dentro del almacén y está limitado a un máximo de 70 caracteres. El mercado identifica dónde se sirven los productos. Para obtener una lista de los mercados admitidos, consulte mercado. Los productos se sirven solo si isPublishingEnabled es true. Para obtener más información sobre cómo puede usar isPublishingEnabled para probar la aplicación, consulte Prueba del código en el espacio aislado.
Actualización de un catálogo en el almacén
Para actualizar un catálogo en el almacén, anexe la plantilla siguiente al URI base.
{bmcMerchantId}/catalogs/{catalogId}
Establezca {bmcMerchantId} en el identificador de la tienda MMC y establezca {catalogId} en el identificador del catálogo.
El cuerpo de la solicitud es un objeto Catalog . Debe especificar los campos siguientes.
Envíe una solicitud HTTP PUT a la dirección URL resultante. Si se actualiza el catálogo, la respuesta contiene el objeto Catalog actualizado.