Compartir a través de

Recurso Products

  • Artículo

El recurso Productos le permite administrar ofertas de productos en la tienda microsoft Merchant Center (MMC). Para obtener información sobre el uso de los recursos de Productos, consulte Administración de sus productos. Para obtener ejemplos que muestran cómo agregar, eliminar y obtener productos, vea Ejemplos de código.

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 que se usan para administrar las ofertas de productos, anexe la plantilla adecuada al URI base.

Plantilla Verbo HTTP Descripción Recurso
{mmcMerchantId}/products/batch POST Use para realizar varias inserciones (actualizaciones), obtiene y elimina en una sola solicitud. El lote no debe incluir varias acciones para el mismo producto. Por ejemplo, la solicitud no debe intentar insertar y eliminar el mismo producto.

Establézcalo {mmcMerchantId} en el identificador de almacén de MMC.		 Solicitud: Batch
Respuesta: Batch
{mmcMerchantId}/products/{productUniqueId} DELETE Use para eliminar una oferta de producto única de la tienda.

Establézcalo {mmcMerchantId} en el identificador de almacén de MMC.

Establezca {productUniqueId} en el identificador de producto completo (por ejemplo, Online:en:US:Sku123).

Si insertó un producto con el mismo identificador en varios catálogos, se eliminará de todos ellos.

Los productos eliminados pueden tardar hasta 12 horas en dejar de entregarse. Se recomienda actualizar la disponibilidad del producto a "fuera de stock" antes de eliminarla.		 Solicitud: N/A
Respuesta: N/A
{mmcMerchantId}/products/{productUniqueId} GET Use para obtener una oferta de producto única de la tienda.

Establézcalo {mmcMerchantId} en el identificador de almacén de MMC.

Establezca {productUniqueId} en el identificador de producto completo (por ejemplo, Online:en:US:Sku123).

Si insertó un producto con el mismo identificador en varios catálogos, el servicio devuelve solo uno de ellos y cuál no está determinado.		 Solicitud: N/A
Respuesta: Producto
{mmcMerchantId}/products GET Use para obtener una lista de productos en la tienda.

Establézcalo {mmcMerchantId} en el identificador de almacén de MMC.		 Solicitud: N/A
Respuesta: Productos
{mmcMerchantId}/products POST Use para insertar (actualizar) una oferta de producto única en la tienda.

Si el producto no existe, se agrega; De lo contrario, el producto se actualiza. Dado que las actualizaciones sobrescriben la oferta actual, debe incluir todos los campos que componen la oferta.

Para insertar la oferta en un catálogo específico, especifique el parámetro de consulta bmc-catalog-id ; De lo contrario, el producto se inserta en el catálogo predeterminado de la tienda.

Establézcalo {mmcMerchantId} en el identificador de almacén de MMC.

Tenga en cuenta que, dado que las solicitudes Get/List y Delete actúan en el almacén y no en un catálogo específico, no debe insertar un producto con el mismo canal, contentLanguage, targetCountry y offerId en varios catálogos.		 Solicitud: Producto
Respuesta: Producto

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.
bmc-catalog-id Opcional. Use para especificar el catálogo en el que insertar (actualizar) ofertas de productos.

Use este parámetro si el almacén contiene varios catálogos. Si no especifica este parámetro, el producto se inserta en el catálogo predeterminado de la tienda.

Este parámetro solo se usa para insertar ofertas de productos. Este parámetro se omite para las solicitudes Get, List y Delete porque funcionan en todos los catálogos.
dry-run Opcional. Use al depurar la aplicación para probar las llamadas. Las llamadas que incluyen este parámetro no afectarán a los datos de producción (los productos no se insertan ni eliminan); sin embargo, la respuesta contendrá los errores que genere la llamada.

Tenga en cuenta las siguientes limitaciones al usar este parámetro.
  • Las operaciones de inserción no devuelven identificadores.
  • El servicio no genera ni devuelve mensajes de error secundarios, como la calidad de los datos, los problemas editoriales y las validaciones relacionadas con la base de datos.
Para obtener más información sobre cómo probar la aplicación, consulte Espacio aislado.
max-results Opcional. Use para especificar el número máximo de elementos que se devolverán en una solicitud List. El valor máximo que puede especificar es 250. El valor predeterminado es 25.
start-token Opcional. Usa para paginar la lista de productos de una tienda. El token identifica la siguiente página de productos que se va a devolver en una solicitud List. No especifique este parámetro en la primera solicitud List. Si el catálogo contiene más del número solicitado de productos (consulte el parámetro de consulta max-results ), la respuesta incluye el nextPageToken campo (consulte Productos), que contiene el valor de token que se usa en la siguiente solicitud List.

Encabezados

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

Encabezado Descripción
AuthenticationToken Encabezado de solicitud.

Establezca este encabezado en un token de acceso de OAuth. Para obtener información sobre cómo obtener un token de acceso, consulte Autenticación de sus 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.
Content-Type Encabezado de solicitud y respuesta.

Tipo de contenido en el cuerpo de la solicitud o respuesta. En el caso de los POST, si usa JSON, establezca este encabezado en application/json. De lo contrario, si usa XML, establezca este encabezado en application/xml.
CustomerAccountId Encabezado de solicitud.

El identificador de cuenta de cualquier cuenta que administre 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 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 de 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
Lote Define la lista de elementos que se procesarán en una solicitud por lotes.
Error Define un error.
ErrorResponse Define el objeto de error de nivel superior para una única inserción de producto.
BatchItemError Define los errores que se produjeron para un elemento durante el procesamiento por lotes.
Elemento Define un elemento en una solicitud o respuesta por lotes.
Producto Define un producto.
ProductCustomAttribute Define un atributo personalizado.
ProductCustomGroup Define un grupo de atributos personalizados.
ProductDestination Define un destino.
ProductPrice Define el precio de un producto.
ProductTax Define la ubicación geográfica que determina los impuestos aplicables.
Productos Define una lista de productos.
ProductShipping Define el costo de envío.
ProductShippingWeight Define el peso de envío del artículo.
UnitPricing Define el precio por unidad del artículo.
Advertencia Define un mensaje de advertencia.

Lote

Define la lista de elementos que se procesarán en una solicitud por lotes. Tenga en cuenta que este objeto se usa en una solicitud y respuesta por lotes.

Nombre Valor Tipo Nombre del elemento XML
Entradas Matriz de elementos que se procesarán en una solicitud por lotes.

El número máximo de elementos que puede especificar es 12 000. Sin embargo, el tamaño máximo de la solicitud es de 4 MB, por lo que el número real de elementos depende del número de atributos de producto (por ejemplo, tamaño, color, patrón) que incluya y si comprime los datos. Por ejemplo, si comprime los datos, es posible que pueda especificar 12 000 elementos, pero si no lo hace, es posible que solo pueda especificar 2000 elementos.		 Elemento[] <lote>

BatchItemError

Define los errores que se produjeron para un elemento durante el procesamiento por lotes.

Nombre Valor Tipo Nombre del elemento XML
errores Lista de errores que se produjeron al procesar el elemento. Error[] <Errores>
código Código de estado HTTP del error. Cadena
mensaje Mensaje asociado al error. Cadena

Error

Define un error.

Nombre Valor Tipo Nombre del elemento XML
domain Únicamente para uso interno. Cadena <dominio>
ubicación No se usa. Cadena <location type="string">
locationType No se usa. Cadena Vea el atributo type del <elemento location> .
mensaje Una descripción del error. Cadena <internalReason>
motivo Motivo por el que se produjo un error en la solicitud. Por ejemplo, se produjo un error en la validación del producto. Cadena <razón>

ErrorResponse

Define el objeto de error de nivel superior para una única inserción de producto.

Nombre Valor Tipo Nombre del elemento XML
error Lista de errores que se produjeron al procesar el elemento. Errores[] <error>

Errores

Define la lista de errores y advertencias de una oferta.

Nombre Valor Tipo Nombre del elemento XML
errores Lista de errores que se produjeron al procesar el elemento. Error[] <Errores>
Advertencias Lista de advertencias que se produjeron al procesar el elemento. La oferta se aceptó, pero debe abordar los problemas lo antes posible. Por ejemplo, MMC devuelve advertencias si no especifica los identificadores gtin, mpn y brand si deben conocerse. Advertencia[] <Advertencias>
código El código de estado HTTP o el error. Cadena
mensaje Mensaje asociado al error. Cadena

Elemento

Define un elemento en una solicitud por lotes.

Nombre Valor Tipo Nombre del elemento XML
batchId Identificador definido por el usuario que identifica este elemento en la solicitud por lotes. Por ejemplo, si el lote contiene 10 elementos, puede asignarles identificadores del 1 al 10. Unsigned Integer <entry batch_id="unsigned integer" method="string">
errores Objeto de error que contiene una lista de errores de validación que se produjeron. La respuesta incluye este campo solo cuando se produce un error. BatchItemError <Errores>
merchantId El id. de la tienda de Merchant Center. Unsigned Long <merchant_id>
método Acción que se va a aplicar al elemento. Los valores posibles son insert, get y delete. Si el elemento agrega o actualiza una oferta de producto, establezca el métodoinserten ; si el elemento está eliminando un producto, establezca el método en delete; y si el elemento obtiene un producto, establezca el métodogeten . Las cadenas no distinguen mayúsculas de minúsculas. Cadena Vea el method atributo del <elemento entry>
producto La oferta del producto. Especifique este campo en una solicitud solo si inserta (actualiza) un producto. La respuesta incluirá este campo solo para obtener e insertar (actualizaciones). Producto <producto>
Productid El identificador de producto completo (por ejemplo, Online:en:US:Sku123). Incluya este campo solo al obtener o eliminar una oferta de producto.

No incluya varios elementos con el mismo identificador de producto en una solicitud por lotes.		 Cadena <product_id>

Producto

Define un producto. Para obtener más información sobre los campos de este objeto, consulte ¿Cómo se organiza el archivo de fuente?

Json y nombre XML Valor Tipo Necesario para insertar
additionalImageLinks

<additional_image_link>		 Las direcciones URL de imágenes adicionales del producto que se pueden usar en el anuncio del producto. Para especificar varias imágenes,

MMC no usa las imágenes adicionales; este campo se incluye para la compatibilidad de Google.		 Cadena[] No
adult

<adulto>		 Valor booleano que determina si el elemento es un producto para adultos. Establézcalo en true si el mercado de destino del elemento es de adultos. El valor predeterminado es false.

Tenga en cuenta que los productos para adultos no son compatibles y se rechazarán.		 Booleano No
adwordsGrouping

<adwords_grouping>		 Un grupo de artículos para las ofertas de costo por adquisición (CPA).

MMC no usa este campo; se incluye para la compatibilidad de Google.		 Cadena No
adwordsLabels

<adwords_label>		 Las etiquetas de los elementos agrupados (consulte adwordsGrouping). Solo se aplica al costo por clic (CPC).

MMC no usa este campo; se incluye para la compatibilidad de Google.		 Cadena[] No
adwordsRedirect

<adwords_redirect>		 Dirección URL que se va a usar en el anuncio del producto. Si se especifica, esta dirección URL debe redirigirse a la dirección URL especificada en el vínculo. Cadena No
ageGroup

<age_group>		 Grupo de edad de destino del elemento. A continuación se muestran los valores posibles.

  • adult
  • Niños
  • bebé
  • niño
  • recién nacido
 Cadena No
disponibilidad

<disponibilidad>		 Estado de disponibilidad del producto. A continuación se muestran los valores posibles.

  • en stock
  • sin existencias
  • preordenar
El valor predeterminado está en stock.
 Cadena Sí
availabilityDate

<availability_date>		 La fecha UTC en la que un producto de pedido previo estará disponible para el envío (consulte el availability campo). Este campo es opcional, pero si conoce la fecha en que el producto pedido previamente estará disponible para el envío, debe establecer este campo. Especifique la fecha en formato ISO 8601.

NOTA: MMC omite actualmente el contenido de este campo.		 Cadena No
marca

<marca>		 La marca, el fabricante o el publicador del artículo. La cadena puede contener un máximo de 10 palabras y 1000 caracteres. Para asegurarse de que la cadena se muestra bien en la experiencia de usuario, debe limitar el nombre de marca a no más de 70 caracteres. Cadena Sí
canal

<canal>		 Canal de ventas del producto. A continuación se muestran los posibles valores que no distinguen mayúsculas de minúsculas.

  • Local
  • Online
Dado que el canal se usa para crear el identificador de producto, es posible que no cambie este campo después de agregar el producto al almacén.		 Cadena Sí
color

<Color>		 Color dominante del producto. Si el color es una combinación de colores, puede especificar una lista delimitada por barras diagonales de hasta 3 colores (por ejemplo, rojo, verde o azul).

Si un vestido está disponible en varios colores, crearía un producto para cada color y usaría itemGroupId para agrupar las variantes del producto.

El campo está limitado a 100 caracteres.

Recomendado para prendas de vestir.		 Cadena No
condición

<condición>		 Condición del producto. A continuación se muestran los valores posibles.

  • Nuevo
  • Reformado
  • used
El valor predeterminado es nuevo.		 Cadena Sí
contentLanguage

<content_language>		 Código de lenguaje ISO 639-1 de dos letras para el producto. A continuación se muestran los posibles valores que no distinguen mayúsculas de minúsculas:
  • Albanés (sq)
  • Bosnio (bs)
  • Búlgaro (bg)
  • Croata (hr)
  • Checo (cs)
  • Neerlandés (nl)
  • Inglés (en)
  • Estonio (et)
  • Francés (fr)
  • Alemán (de)
  • Griego (el)
  • Húngaro (hu)
  • Islandés (es)
  • Italiano (it)
  • Letón (lv)
  • Lituano (lt)
  • Macedonio (mk)
  • Maltés (mt)
  • Polaco (pl)
  • Portugués (pt)
  • Rumano (ro)
  • Serbio (sr)
  • Eslovaco (sk)
  • Esloveno (sl)
  • Español (es)
  • Sueco (sv)
  • Turco (tr)
Dado que el idioma se usa para crear el identificador de producto, es posible que no cambie este campo después de agregar el producto a la tienda.		 Cadena Sí
customAttributes

<custom_attribute>		 Lista de atributos personalizados usados por el comerciante. ProductCustomAttribute[] No
customGroups<custom_group> Lista de grupos personalizados usados por el comerciante. ProductCustomGroup[] No
customLabel0

<custom_label_0>		 Etiqueta personalizada 0, que se usa para filtrar productos para las campañas de Microsoft Shopping. La etiqueta está limitada a 100 caracteres. Cadena No
customLabel1

<custom_label_1>		 Etiqueta personalizada 1, que se usa para filtrar productos para las campañas de Microsoft Shopping. La etiqueta está limitada a 100 caracteres. Cadena No
customLabel2

<custom_label_2>		 Etiqueta personalizada 2, que se usa para filtrar productos para las campañas de Microsoft Shopping. La etiqueta está limitada a 100 caracteres. Cadena No
customLabel3

<custom_label_3>		 Etiqueta personalizada 3, que se usa para filtrar productos para las campañas de Microsoft Shopping. La etiqueta está limitada a 100 caracteres. Cadena No
customLabel4

<custom_label_4>		 Etiqueta personalizada 4, que se usa para filtrar productos para las campañas de Microsoft Shopping. La etiqueta está limitada a 100 caracteres. Cadena No
description

<descripción>		 Descripción del producto. Es posible que la descripción no incluya texto promocional. La descripción está limitada a un máximo de 10 000 caracteres y puede incluir cualquier carácter Unicode.

La descripción se someterá a revisión editorial.		 Cadena No
Destinos

<destino>		 Destinos previstos del producto.

MMC no usa este campo; se incluye para la compatibilidad de Google.		 ProductDestination[] No
energyEfficiencyClass

<energy_efficiency_class>		 La clase de eficiencia energética tal como se define en la Directiva ue 2010/30/UE. A continuación se muestran los valores posibles.

  • A
  • A+
  • A++
  • A+++
  • N
  • C
  • D
  • E
  • F
  • G
 Cadena No
expirationDate

<expiration_date>		 Fecha y hora UTC que especifica cuándo expirará el producto.

Si no especifica una fecha de expiración, el producto expira 30 días a partir de la fecha y hora en que agrega o actualiza el producto (la fecha y hora se basan en la zona horaria del servidor de Microsoft).

Use este campo para especificar una fecha de expiración inferior a 30 días a partir de hoy.

La fecha de expiración siempre debe incluir el componente de hora y especificar la zona horaria o la información de desplazamiento. Si no es así, la API intentará determinar la zona horaria mediante targetCountry. Para los países o regiones con varias zonas horarias, la API determina la zona horaria que se va a usar. Por ejemplo, si el país es EE. UU., la API usará la hora estándar del pacífico (PST).

Debe realizar un seguimiento de los productos que están a punto de expirar y antes de que expiren actualicen su fecha de expiración o simplemente actualicen el producto (no es necesario actualizar ninguno de los campos del producto), lo que extenderá automáticamente la fecha de expiración otros 30 días. Si establece explícitamente la fecha de expiración, debe establecer una nueva fecha de expiración usted mismo; actualizar el producto no extenderá automáticamente la fecha de expiración otros 30 días en este caso.		 Cadena No
gender

<género>		 El género al que se dirige el producto. A continuación se muestran los valores posibles.

  • hembra
  • masculino
  • unisex
 Cadena No
googleProductCategory

<google_product_category>		 La categoría de producto en la que se encuentra el producto. Puede especificar una cadena de categoría (por ejemplo, Animals & Pet Supplies Pet supplies > Bird Supplies > ) o un id. de categoría (por ejemplo, 3). Para una cadena de categoría, la lista de subcategorías está delimitada por el símbolo mayor que (''>). El campo está limitado a 255 caracteres. Cadena No
gtin

<gtin>		 Número de artículo comercial global (GTIN) asignado por el fabricante. Si el fabricante asigna un GTIN, debe especificarlo. Los siguientes son tipos de GTIN.

  • EAN (número de artículo europeo)
  • ISBN (Número de libro Standard internacional)
  • JAN (número de artículo japonés)
  • UPC (código de producto universal)
 Cadena Sí
identificación

<identificación>		 Identificador de producto completo. El identificador es una composición de channel, contentLanguage, targetCountry y offerId. El identificador distingue mayúsculas de minúsculas.

Use este identificador para obtener o eliminar un producto.		 Cadena No
identifierExists

<identifier_exists>		 Valor booleano que determina si la oferta de producto especifica los identificadores gtin, mpn o brand . The default is true. Establezca en false si no especifica los tres identificadores.

Los identificadores de producto únicos definen un producto en un marketplace global. El etiquetado de los productos con identificadores únicos facilita a los clientes la búsqueda de sus productos. Debe especificar los tres identificadores, si se conocen.		 Booleano No
imageLink

<image_link>		 Dirección URL de una imagen del producto que se puede usar en el anuncio del producto. La dirección URL está limitada a 1000 caracteres y puede usar el protocolo HTTP o HTTPS. Los tipos de imagen permitidos son bmp, gif, exif, jpg, png y tiff. El tamaño de imagen recomendado es de 200 x 200 píxeles. Es posible que la imagen no supere los 3,9 MB.

La imagen se someterá a revisión editorial.		 Cadena Sí
isBundle

<is_bundle>		 Valor booleano que determina si el producto es una agrupación definida por el comerciante. El valor es true si el producto es una agrupación. Booleano No
itemGroupId

<item_group_id>		 Identificador que se puede usar para agrupar todas las variantes del mismo producto. Por ejemplo, si el vestido está disponible en 3 colores, puede crear un producto para cada color y usar este identificador para agruparlos. Normalmente, se agrupan elementos que varían según el color, el material, el patrón o el tamaño.

El identificador debe ser único dentro de un catálogo y está limitado a 50 caracteres.		 Cadena No
kind

<amable>		 Tipo del objeto. Este campo se establece en content#product. Cadena No
enlace

<enlace>		 Dirección URL a la página del producto en su sitio web. La dirección URL está limitada a 2000 caracteres y puede usar el protocolo HTTP o HTTPS. El dominio debe coincidir con el dominio del almacén.

El vínculo se usa en el anuncio del producto. Es posible que no se redirija la dirección URL. Para usar otra dirección URL en el anuncio del producto que se pueda redirigir a esta dirección URL, consulte adwordsRedirect.

La página web a la que apunta este vínculo se someterá a revisión editorial.		 Cadena Sí
material

<material>		 El material dominante del producto. Si el material es una mezcla de materiales, puede especificar una lista delimitada por barras diagonales de hasta 3 materiales (por ejemplo, cuero, ante o seda).

Si un vestido está disponible en varios materiales, crearía un producto para cada material y usaría itemGroupId para agrupar las variantes del producto.

El campo está limitado a 200 caracteres.

Recomendado para prendas de vestir.		 Cadena No
mobileLink

<mobile_link>		 Dirección URL a una versión optimizada para dispositivos móviles de la página web que contiene información sobre el producto (consulte el vínculo). Cadena No
multipack

<multipack>		 El número de productos idénticos que se venden como una sola unidad (por ejemplo, 4 linternas). Al establecer el precio, debe ser el precio total del paquete múltiple. Entero No
mpn

<mpn>		 Número de parte del fabricante (MPN) del producto. Si el fabricante asigna un MPN, debe especificarlo. El MPN está limitado a 70 caracteres. Cadena Sí
offerId

<offer_id>		 Identificador definido por el usuario del producto que se ofrece. El identificador de la oferta no distingue mayúsculas de minúsculas y debe ser único dentro de un catálogo y está limitado a un máximo de 50 caracteres.

Dado que el identificador de la oferta se usa para crear el identificador de producto, es posible que no cambie este campo después de agregar el producto a la tienda.		 Cadena Sí
onlineOnly

<online_only>		 Valor booleano que determina si el producto solo está disponible para la compra en línea. El valor es true si el producto solo está disponible en línea. El valor predeterminado es false. Booleano No
pattern

<patrón>		 El patrón o la impresión gráfica del producto (por ejemplo, plaid). El patrón está limitado a 100 caracteres.

Si un vestido está disponible en varios patrones, crearía un producto para cada patrón y usaría itemGroupId para agrupar las variantes del producto.

Recomendado para prendas de vestir.		 Cadena No
precio

<precio>		 El precio del producto. Especifique el precio en la moneda del país de destino. Para obtener información sobre si se deben incluir impuestos en el precio, consulte La directiva de impuestos del catálogo de Microsoft Merchant Center. El precio debe coincidir con el precio mostrado en la página web del producto (ver vínculo), y debe estar en el intervalo de 0,01 (1 céntimo) a 10000000,00 (10 millones).

Sin embargo, si se cumplen las condiciones siguientes, puede establecer el precio en 0,0 (cero).

1. El campo googleProductCategory se establece en una de las categorías siguientes:
    - Teléfonos móviles de telefonía > de comunicaciones electrónicas >>
    - Equipos electrónicos Tabletas >>
2. El campo de título contiene una de las siguientes palabras clave:
    -contrato
    -plazo
    -arrendamiento
    -pago

Las palabras clave anteriores se muestran en inglés; sin embargo, el título y la palabra clave deben estar en el idioma del mercado especificado.

Normalmente, el título contendrá expresiones como "... con plan de cuotas" o "... sólo con contrato". La palabra clave contract se puede usar en todos los mercados; sin embargo, el pago a plazos y la concesión solo se pueden usar en el mercado estadounidense. 		ProductPrice Yes
productType

<product_type>		 La categoría de producto definida por el anunciante, que puede ser diferente de googleProductCategory. Por ejemplo, Animales & suministros de mascotas Suministros > de mascotas suministros > de aves veterinarias > . La lista de subcategorías está delimitada por el símbolo mayor que (''>). El campo está limitado a 750 caracteres.

Puede especificar varias cadenas de categoría delimitadas por comas. Por ejemplo, Trajes & Accesorios > Peluca Accesorios Peluca Gorras > , Trajes & Accesorios > Peluca Accesorios > Peluca Pegamento.		 Cadena No
promotionId

<promotion_id>		 Una lista delimitada por comas de identificadores que identifican las promociones en la fuente Promociones. Puede especificar un máximo de 10 identificadores de promoción.

El identificador debe contener un mínimo de 1 carácter y un máximo de 60 caracteres. Los caracteres permitidos son cualquier carácter alfanumérico, un guión (-) y un carácter de subrayado (_).

Todos los identificadores de un mercado (vea contentLanguage y targetCountry) deben ser únicos. Por ejemplo, dentro de un mercado, es posible que no uses PROMO1 y promo1, pero podrías usar PROMO1 en el mercado en-US y promo1 en el mercado en-GB. Puede especificar el mismo identificador de promoción único en uno o varios productos.

Microsoft promueve el producto si el identificador que especifique coincide con un identificador de promoción en la fuente Promociones (para el mismo país de destino). Los identificadores solo coinciden si el uso de mayúsculas y minúsculas es el mismo. Por ejemplo, los identificadores coinciden si el identificador del producto es PROMO1 y el id. de la fuente es PROMO1, pero no coinciden si el identificador de la fuente es Promo1.

Para asegurarse de que el producto no se promociona accidentalmente en el futuro, debe quitar los identificadores de promociones que han finalizado. Aunque el identificador no se puede volver a usar en una fuente promociones durante 6 meses después de que finalice la promoción, si el identificador se reutiliza en otra promoción después de eso, el producto se promocionará.		 Cadena No
salePrice

<sale_price>		 Precio de venta del artículo. El precio de venta debe estar comprendido entre 0,01 (1 céntimo) y 10000000,00 (10 millones).

Para artículos de venta, establezca tanto el precio de venta como la fecha de vigencia de la venta (consulte salePriceEffectiveDate). Si establece el precio de venta pero no la fecha de vigencia del precio de venta, el precio de venta seguirá siendo utilizado hasta que expire el producto o establezca una fecha de vigencia.

Si se cumplen las condiciones siguientes, puede establecer el precio de venta en 0,0 (cero).

1. El campo googleProductCategory se establece en una de las categorías siguientes:
    - Teléfonos móviles de telefonía > de comunicaciones electrónicas >>
    - Equipos electrónicos Tabletas >>
2. El campo de título contiene una de las siguientes palabras clave:
    -contrato
    -plazo
    -arrendamiento
    -pago

Las palabras clave anteriores se muestran en inglés; sin embargo, el título y la palabra clave deben estar en el idioma del mercado especificado.

Normalmente, el título contendrá expresiones como "... con plan de cuotas" o "... sólo con contrato". La palabra clave contract se puede usar en todos los mercados; sin embargo, el pago a plazos y la concesión solo se pueden usar en el mercado estadounidense. 		ProductPrice No
salePriceEffectiveDate

<sale_price_effective_date>		 Fecha de inicio y finalización de la venta. Especifique las fechas en formato ISO 8601 . Por ejemplo, 2016-04-05T08:00-08:00/2016-04-10T19:30-08:00 (use una barra diagonal ('/') para separar las fechas de inicio y finalización. Para más información, vea salePrice. Cadena No
sellerName

<seller_name>		 El nombre del comerciante que vende el producto. Solo lo usan los agregadores para identificar al comerciante. Los agregadores son sitios de terceros que se comportan en nombre de comerciantes individuales. Los productos que un agregador envía en nombre del comerciante deben cumplir con las directivas y términos de servicio de Microsoft Advertising.

Los agregadores deben establecer este campo en el nombre de los vendedores. Si el autor de la llamada no es un agregador y este campo no está establecido, el valor predeterminado será el nombre del almacén.

El nombre está limitado a 255 caracteres.		 Cadena No
naviero

<naviero>		 El precio para enviar el producto en función de la ubicación.

NOTA: El envío es obligatorio si el país de destino es DE (Alemania); De lo contrario, es opcional.		 ProductShipping[] Yes
shippingLabel

<shipping_label>		 La etiqueta de envío.

NOTA: La información de envío es necesaria si el país de destino es DE (Alemania); De lo contrario, es opcional.		 Cadena Sí
shippingWeight

<shipping_weight>		 El peso del producto. El peso se utiliza con fines de envío.

NOTA: La información de envío es necesaria si el país de destino es DE (Alemania); De lo contrario, es opcional.		 ProductShippingWeight Yes
Tamaños

<tamaño>		 Tamaños disponibles del producto. Por ejemplo, pequeño, mediano y grande. Aplique el tamaño de forma coherente. El valor de tamaño está definido por el usuario, pero debe basarse en el país de destino. Este campo es necesario para todos los productos de accesorios de ropa & al dirigirse a: Francia, Alemania, Reino Unido y Estados Unidos. Cadena[] No
sizeSystem

<size_system>		 El sistema de medición utilizado para ajustar el tamaño del producto. Por ejemplo, los zapatos se pueden ajustar mediante el sistema de EE. UU. o el sistema del Reino Unido.

A continuación se muestran los valores posibles.

  • UA
  • DE
  • FR
  • Reino Unido
  • EE. UU.
El valor predeterminado es el sistema utilizado por el país de destino. Recomendado para prendas de vestir.		 Cadena No
sizeType

<size_type>		 Corte del producto. A continuación se muestran los valores posibles.

  • regular
  • maternidad
  • Petite
  • más
  • grande y alto
El valor predeterminado es Regular. Recomendado para prendas de vestir.		 Cadena No
targetCountry

<target_country>		 El código de país ISO 3166 de dos letras del país de destino (el país donde desea anunciar el producto). El país debe coincidir con el mercado especificado por el catálogo.

A continuación se muestran los posibles valores que no distinguen mayúsculas de minúsculas:

  • AD (Andorra)
  • AL (Albania)
  • AR (Argentina)
  • AW (Aruba)
  • AT (Austria)
  • AU (Australia)
  • BS (Bahamas)
  • BD (Bangladesh)
  • BA (Bosnia y Herzegovina)
  • BE (Bélgica)
  • BO (Bolivia)
  • BG (Bulgaria)
  • BR (Brasil)
  • BN (Brunei)
  • CA (Canadá)
  • KY (Islas Caimán)
  • CH (Suiza)
  • CL (Chile)
  • CO (Colombia)
  • CR (Costa Rica)
  • CY (Chipre)
  • CZ (República Checa)
  • DE (Alemania)
  • DK (Dinamarca)
  • DM (Dominica)
  • DO (República Dominicana)
  • CE (Ecuador)
  • SV (El Salvador)
  • EE (Estonia)
  • ES (España)
  • FJ (Fiji)
  • FI (Finlandia)
  • FR (Francia)
  • GF (Guayana Francesa)
  • PF (Polinesia Francesa)
  • GB (Gran Bretaña)
  • GR (Grecia)
  • GU (Guam)
  • GT (Guatemala)
  • GY (Guyana)
  • HT (Haití)
  • HN (Honduras)
  • RR. HH. (Croacia)
  • HU (Hungría)
  • Id. (Indonesia)
  • IE (Irlanda)
  • IN (India)
  • IS (Islandia)
  • TI (Italia)
  • LI (Liechtenstein)
  • LT (Lituania)
  • LU (Luxemburgo)
  • LV (Letonia)
  • MV (Maldivas)
  • MC (Mónaco)
  • ME (Montenegro)
  • MK (Macedonia del Norte)
  • MT (Malta)
  • MQ (Martinica)
  • MY (Malasia)
  • MX (México)
  • MN (Mongolia)
  • MS (Montserrat)
  • NP (Nepal)
  • NL (Países Bajos)
  • NC (Nueva Caledonia)
  • NO (Noruega)
  • NZ (Nueva Zelanda)
  • PA (Panamá)
  • PG (Papúa Nueva Guinea)
  • PH (Filipinas)
  • PY (Paraguay)
  • PE (Perú)
  • PL (Polonia)
  • PT (Portugal)
  • PR (Puerto Rico)
  • RO (Rumania)
  • RS (Serbia)
  • LK (Sri Lanka)
  • SE (Suecia)
  • SG (Singapur)
  • SI (Eslovenia)
  • SK (Eslovaquia)
  • SM (San Marino)
  • TH (Tailandia)
  • TT (Trinidad y Tobago)
  • TR (Türkiye)
  • EE. UU. (Estados Unidos)
  • UT (Uruguay)
  • VA (Ciudad del Vaticano)
  • VE (Venezuela)
  • VN (Vietnam)
  • ZA (Sudáfrica)
Dado que el país se usa para crear el identificador de producto, es posible que no cambie este campo después de agregar el producto a la tienda.		 Cadena Sí
impuestos

<impuesto>		 La información fiscal del producto.

MMC no usa este campo; se incluye para la compatibilidad de Google.		 ProductTax[] No
título

<título>		 El título del producto (por ejemplo, Zapatos de mujer). Es posible que el título no incluya texto promocional. El título está limitado a un máximo de 150 caracteres y puede incluir cualquier carácter Unicode.

El título se someterá a revisión editorial.		 Cadena Sí
unitPricingBaseMeasure

<unit_pricing_base_measure>		 La medida base del producto para los precios (por ejemplo, 100 ml significa que el precio se calcula en función de una unidad de 100 ml).
  • Peso: oz, lb, mg, g, kg
  • Volumen (US imperial): floz, pt, qt, gal
  • Volumen: ml, cl, l, cbm
  • Longitud: in, ft, yd, cm, m
  • Área: sqft, sqm
  • Por unidad: ct

 UnitPricingBaseMeasure No
unitPricingMeasure

<unit_pricing_measure>		 Medida y dimensión del producto a medida que se vende.
  • Peso: oz, lb, mg, g, kg
  • Volumen (US imperial): floz, pt, qt, gal
  • Volumen: ml, cl, l, cbm
  • Longitud: in, ft, yd, cm, m
  • Área: sqft, sqm
  • Por unidad: ct

 UnitPricingMeasure No
validDestinations

<validated_destination>		 Lista de solo lectura de destinos previstos que han pasado la validación.

MMC no usa este campo; se incluye para la compatibilidad de Google.		 Cadena[] No
Advertencias Una lista de advertencias sobre problemas con la oferta del producto. La oferta se aceptó, pero debe abordar los problemas lo antes posible. Por ejemplo, MMC devuelve advertencias si no especifica los identificadores gtin, mpn y brand si deben conocerse.

La oferta incluye este campo solo en la respuesta de una inserción o actualización.		 Advertencia[] No

ProductCustomAttribute

Define un atributo personalizado.

Nombre Valor Tipo Nombre del elemento XML
name Obtiene o establece el nombre del atributo. Cadena <nombre>
type Obtiene o establece el tipo del atributo. A continuación se muestran los valores posibles.

  • booleano
  • datetimerange
  • float
  • grupo
  • Entero
  • precio
  • text
  • time
  • URL
 Cadena <tipo>
unidad Obtiene o establece la unidad de medida del atributo. Se usa solo para valores de tipo INT y FLOAT. Cadena <unidad>
valor Obtiene o establece el valor del atributo. Cadena <valor>

ProductCustomGroup

Define un grupo de atributos de cliente.

Nombre Valor Tipo Nombre del elemento XML
atributos Obtiene o establece los atributos del grupo. ProductCustomAttribute <Atributos>
name Obtiene o establece el nombre del grupo. Cadena <nombre>

ProductDestination

Define un destino.

Nombre Valor Tipo Nombre del elemento XML
intención A continuación se muestran los valores posibles.

  • Es el valor predeterminado.
  • Excluidos
  • opcional
  • necesario
 Cadena <intención>
destinationName Obtiene o establece el nombre del destino. Cadena <destination_name>

ProductPrice

Define el precio o el precio de venta de un producto.

Nombre Valor Tipo Nombre del elemento XML
divisa Obtiene o establece la moneda en la que se indica el precio. Especifique la moneda mediante códigos de moneda ISO 4217. A continuación se muestran los valores posibles.

  • AUD (dólar australiano)
  • CHF (franco suizo)
  • CAD (dólar canadiense)
  • EUR (Euro)
  • GBP (libra de Gran Bretaña)
  • IDR (rupia indonesia)
  • INR (rupia india)
  • MYR (ringgit malayo)
  • NZD (dólar neozelandés)
  • PHP (peso de Filipinas)
  • SEK (corona sueca)
  • SGD (dólar de Singapur)
  • THB (baht tailandés)
  • USD (Estados Unidos dólar)
  • VND (dong vietnamita)
 Cadena currency atributo.

Por ejemplo, <price currency="USD">.
valor Obtiene o establece el precio del elemento. No incluya símbolos de moneda como '$'. Doble Valor de texto.

Por ejemplo, <price currency="USD">38.0<\price>.

Productos

Define una lista de productos. Tenga en cuenta que este es el objeto de nivel superior que devuelve la solicitud List.

Nombre Valor Tipo Nombre del elemento XML
kind Obtiene el tipo del objeto. Este campo se establece en content#productsListResponse. Cadena <amable>
nextPageToken Obtiene el token usado para obtener la siguiente página de resultados. Si el objeto no incluye este campo, no hay más páginas que obtener. Consulte start-token. Cadena <next_page_token>
recursos Obtiene la lista de productos. Si el catálogo no contiene ninguna oferta, la matriz está vacía. Producto[] <productos>

ProductShipping

Define el costo de envío.

Nombre Valor Tipo Nombre del elemento XML
country Obtiene o establece el código de país ISO 3166 de dos letras del país al que se envía el elemento. Cadena <país>
locationGroupName Obtiene o establece el nombre del grupo de ubicación. Cadena <location_group_name>
locationId Obtiene o establece el identificador de la ubicación geográfica a la que se envía el elemento. Para obtener una lista de identificadores, consulte Códigos de ubicación geográfica. Cadena <location_id>
postalCode Obtiene o establece el código postal o el intervalo de códigos postales de la ubicación a la que se envía el elemento. Puede especificar el código postal de la siguiente manera:

  • Un código postal completo: 94114

  • Código postal con un carácter comodín (solo sufijo): 94*

  • Un intervalo de códigos: 94002-95460

  • Un intervalo de códigos con caracteres comodín (los prefijos de código postal deben tener la misma longitud: 94*-95*
 Cadena <postal_code>
precio Obtiene o establece el precio fijo para enviar el elemento a la ubicación especificada. ProductPrice <precio>
región Obtiene o establece la región geográfica a la que se envía el elemento (por ejemplo, código postal). Cadena <región>
servicio Obtiene o establece una descripción de texto que describe la clase de servicio o la velocidad de entrega. Cadena <servicio>

ProductShippingWeight

Define el peso de envío del artículo.

Nombre Valor Tipo Nombre del elemento XML
unidad Obtiene o establece la unidad de medida. Cadena unit atributo.

Por ejemplo, <shipping_weight unit="oz">.
valor Obtiene o establece el peso del elemento, que se usa para calcular el costo de envío del artículo. Cadena Valor de texto.

Por ejemplo, <shipping_weight unit="oz">20.3<shipping_weight>.

ProductTax

Define la ubicación geográfica que determina los impuestos aplicables.

Nombre Valor Tipo Nombre del elemento XML
country Obtiene o establece el país cuyo tipo impositivo se aplica. Usa el código de país ISO 3166 de dos letras. Cadena <país>
locationId Obtiene o establece el identificador de la ubicación geográfica cuya tasa de impuestos se aplica. Para obtener una lista de identificadores, consulte Códigos de ubicación geográfica. Long <location_id>
postalCode Obtiene o establece el código postal o el intervalo de códigos postales cuyo tipo impositivo se aplica. Puede especificar el código postal de la siguiente manera:

  • Un código postal completo: 94114

  • Código postal con un carácter comodín (solo sufijo): 94*

  • Un intervalo de códigos: 94002-95460

  • Un intervalo de códigos con caracteres comodín (los prefijos de código postal deben tener la misma longitud: 94*-95*
 Cadena <postal_code>
tasa Obtiene o establece el porcentaje de impuestos que se va a aplicar al precio del elemento. Para especificar una tasa del 5 %, establezca este campo en 5. Para especificar una tasa del 9,8 %, establezca este campo en 9,8. Doble <tasa>
región Obtiene o establece una región geográfica cuyo tipo impositivo se aplica. Cadena <región>
taxShip Obtiene o establece un valor booleano que determina si se debe aplicar el impuesto al costo de envío. Establézcalo en true si se cobra impuestos al realizar el envío. Booleano <navío>

UnitPricing

Define el precio por unidad del artículo.

Nombre Valor Tipo Nombre del elemento XML
unidad Obtiene o establece la unidad de medida. Por ejemplo, oz si el precio es por onza. Cadena unit atributo.

Por ejemplo, <unit_pricing_measure unit="oz">
valor Obtiene o establece el precio por unidad. Doble Valor de texto.

Por ejemplo, <unit_pricing_measure unit="oz">34.5<\unit_pricing_measure>

Advertencia

Define un mensaje de advertencia.

Nombre Valor Tipo Nombre del elemento XML
domain Únicamente para uso interno. Cadena <dominio>
mensaje Descripción de la advertencia. Cadena <internalReason>
motivo El motivo por el que la oferta generó una advertencia. Por ejemplo, no proporcionó un identificador (gtin, mpn o marca) cuando se sabe que el fabricante los ha asignado. Cadena <razón>

Códigos de estado HTTP

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

Código de estado Descripción
200 Correcto.
204 Eliminó correctamente el producto.
400 Solicitud incorrecta. Un valor de parámetro de consulta no es válido o algo en el cuerpo de la solicitud no es válido.

Batch: si se produce un error, el elemento de lote que produjo un error incluirá los errores.
401 No autorizado. Las credenciales del usuario no son válidas.
404 No encontrado.
409 Conflicto. No se pudo completar la operación debido a un conflicto con el estado actual del recurso.
413 Entidad de solicitud demasiado grande. El tamaño de la solicitud supera el máximo permitido.
500 Error del servidor.