REST Resource: accounts.products

Recurso: Producto

El producto procesado, creado a partir de varias [entradas de productos][[google.shopping.content.bundles.Products.ProductInput] después de aplicar reglas y fuentes de datos complementarias. Este producto procesado coincide con lo que se muestra en tu cuenta de Merchant Center, los anuncios de Shopping y otras plataformas de Google. Cada producto se compila a partir de una entrada de producto de fuente de datos principal y varias entradas complementarias de fuente de datos. Después de insertar, actualizar o borrar una entrada de producto, pueden pasar varios minutos antes de que se pueda recuperar el producto procesado actualizado.

Todos los campos del producto procesado y sus mensajes secundarios coinciden con el nombre del atributo correspondiente en las especificaciones de datos de productos, con algunas excepciones.

Representación JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Campos
name

string

Es el nombre del producto. Formato: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Solo salida. Es el canal del producto.
offerId

string

Solo salida. Es el identificador único del producto. Esto es lo mismo para la entrada del producto y el producto procesado. Los espacios en blanco iniciales y finales se quitan y se reemplazan varios espacios en blanco al momento del envío. Consulta las especificaciones de datos de productos para obtener más detalles.
contentLanguage

string

Solo salida. Corresponde al código de idioma ISO 639-1 de dos letras del producto.
feedLabel

string

Solo salida. Es la etiqueta de feed del producto.
dataSource

string

Solo salida. Es la fuente principal de datos del producto.
attributes

object (Attributes)

Solo salida. Una lista de atributos de productos.
customAttributes[]

object (CustomAttribute)

Solo salida. Una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de las especificaciones de datos en su formato genérico (por ejemplo, { "name": "size type", "value": "regular" }). Esto es útil para enviar atributos que la API no expone de forma explícita, como los atributos adicionales que se usan para Comprar con Google.
productStatus

object (ProductStatus)

Solo salida. El estado de un producto, problemas de validación de datos, es decir, información sobre un producto calculada de forma asíncrona.
versionNumber

string (int64 format)

Solo salida. Representa la versión existente (actualidad) del producto, que se puede usar para mantener el orden correcto cuando se realizan varias actualizaciones al mismo tiempo.

Si se establece, no se podrá insertar cuando el número de versión sea inferior al número de versión actual del producto existente. La reinserción (por ejemplo, actualizar el producto después de 30 días) se puede realizar con el versionNumber actual.

Solo es compatible con las inserciones en fuentes de datos principales.

Si se impide la operación, se arrojará la excepción anulada.

Atributos

Atributos.

Representación JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Campos
expirationDate

string (Timestamp format)

Indica la fecha en la que debe caducar el artículo, como se especifica al momento de la inserción, en formato ISO 8601. La fecha de vencimiento real se expone en productstatuses como googleExpirationDate y podría ser anterior si expirationDate es demasiado lejana en el futuro.
disclosureDate

string (Timestamp format)

Es la fecha y hora en que una oferta se hace visible en los resultados de la búsqueda de las plataformas de YouTube de Google, en formato ISO 8601. Consulte [Fecha de divulgación]( https://support.google.com/merchants/answer/13034208) para obtener más información.
availabilityDate

string (Timestamp format)

El día en que un producto pedido por adelantado estará disponible para la entrega, en formato ISO 8601.
price

object (Price)

Precio del artículo.
installment

object (Installment)

Indica la cantidad y el importe de las cuotas que se deben pagar por un artículo.
subscriptionCost

object (SubscriptionCost)

Cantidad de períodos (meses o años) y el importe del pago por período de un elemento con un contrato de suscripción asociado.
loyaltyPoints

object (LoyaltyPoints)

Puntos de lealtad que reciben los usuarios después de comprar el artículo. Oferta válida solo para Japón.
loyaltyPrograms[]

object (LoyaltyProgram)

Es una lista de información del programa de lealtad que se usa para mostrar los beneficios de lealtad (por ejemplo, mejores precios, puntos, etc.) al usuario de este elemento.
productTypes[]

string

Categorías del artículo (con el formato que se indica en las especificaciones de datos de productos)
salePrice

object (Price)

Es el precio de oferta publicado del artículo.
salePriceEffectiveDate

object (Interval)

Período en el que el artículo está en oferta (consulta las especificaciones de datos de productos).
productHeight

object (ProductDimension)

Es la altura del producto en las unidades proporcionadas. El valor debe ser entre 0 (exclusivo) y 3,000 (inclusive).
productLength

object (ProductDimension)

Es la longitud del producto en las unidades proporcionadas. El valor debe ser entre 0 (exclusivo) y 3,000 (inclusive).
productWidth

object (ProductDimension)

Es el ancho del producto en las unidades proporcionadas. El valor debe ser entre 0 (exclusivo) y 3,000 (inclusive).
productWeight

object (ProductWeight)

Indica el peso del producto en las unidades proporcionadas. El valor debe estar comprendido entre 0 (exclusivo) y 2000 (inclusive).
shipping[]

object (Shipping)

Reglas de envío.
freeShippingThreshold[]

object (FreeShippingThreshold)

Son las condiciones que se deben cumplir para que un producto tenga envío gratis.
shippingWeight

object (ShippingWeight)

Es el peso del artículo para el envío.
shippingLength

object (ShippingDimension)

Es la longitud del artículo para el envío.
shippingWidth

object (ShippingDimension)

Es el ancho del artículo para el envío.
shippingHeight

object (ShippingDimension)

Altura del artículo para el envío.
sizeTypes[]

string

Es el corte del artículo. Se puede usar para representar tipos de tallas combinados de artículos de indumentaria. Se puede proporcionar un máximo de dos tipos de tamaño (consulta [https://support.google.com/merchants/answer/6324497](tipo de talla)).
taxes[]

object (Tax)

Información fiscal.
unitPricingMeasure

object (UnitPricingMeasure)

Indica la medida y la dimensión de un artículo.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

La preferencia del denominador del precio unitario.
adsLabels[]

string

Es similar a adsGrouping, pero solo funciona en CPC.
costOfGoodsSold

object (Price)

Costo de bienes vendidos. Se usa para generar informes de ganancias brutas.
productDetails[]

object (ProductDetail)

Especificaciones técnicas o detalles adicionales del producto.
productHighlights[]

string

Incluye viñetas que describen los aspectos más relevantes de un producto.
displayAdsSimilarIds[]

string

Recomendaciones especificadas por el anunciante.
promotionIds[]

string

Es el ID único de una promoción.
includedDestinations[]

string

Es la lista de destinos que se deben incluir para este objetivo (corresponde a las casillas de verificación marcadas en Merchant Center). Los destinos predeterminados siempre se incluyen, a menos que se proporcionen en excludedDestinations.
excludedDestinations[]

string

Es la lista de destinos que se excluirán para este objetivo (corresponde a las casillas de verificación desmarcadas en Merchant Center).
shoppingAdsExcludedCountries[]

string

Lista de códigos de país (ISO 3166‐1 alfa‐2) para excluir la oferta del destino de los anuncios de Shopping. Los países de esta lista se quitan de los países establecidos en la configuración de la fuente de datos.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Campos adicionales para exportar al programa Cloud Retail.
certifications[]

object (Certification)

Certificaciones de productos, por ejemplo, para el etiquetado de eficiencia energética de los productos registrados en la base de datos del EPREL de la UE Para obtener más información, consulte el artículo del Centro de ayuda.
autoPricingMinPrice

object (Price)

Una protección en los proyectos “Descuentos automatizados” (https://support.google.com/merchants/answer/10295759) y “Promociones dinámicas” (https://support.google.com/merchants/answer/13949249), que garantizan que los descuentos en las ofertas de los comercios no sean inferiores a este valor y, por lo tanto, se preserva el valor y la rentabilidad de la oferta.
identifierExists

boolean

Establece este valor como falso cuando el artículo no tenga identificadores únicos de producto apropiados para su categoría, como GTIN, MPN y marca. Si no se proporciona, el valor predeterminado es verdadero.
isBundle

boolean

Indica si el artículo es un paquete definido por el comercio. Un paquete es una agrupación personalizada de diferentes productos que vende un comercio por un precio único.
title

string

Es el título del artículo.
description

string

Es la descripción del artículo.
adult

boolean

Se establece como verdadero si el artículo está dirigido a adultos.
ageGroup

string

Es la edad de segmentación del artículo.
availability

string

Es el estado de disponibilidad del artículo.
brand

string

Marca del artículo
color

string

Es el color del artículo.
condition

string

Estado o condición del artículo.
gender

string

Género objetivo del artículo.
googleProductCategory

string

La categoría de Google del artículo (consulta la taxonomía de productos de Google). Cuando consultes productos, este campo contendrá el valor que proporcionó el usuario. Actualmente, no hay forma de recuperar las categorías de productos de Google asignadas automáticamente a través de la API.
gtin

string

Es el código comercial global de artículo (GTIN).
itemGroupId

string

Es el identificador compartido para todas las variantes del mismo producto.
material

string

Indica el material del que está hecho el artículo.
mpn

string

Es el número de pieza del fabricante (MPN) del artículo.
pattern

string

El diseño del artículo (por ejemplo, lunares).
sellOnGoogleQuantity

string (int64 format)

Es la cantidad del producto que está disponible para venderse en Google. Compatible solo con productos en línea.
maxHandlingTime

string (int64 format)

Tiempo máximo de preparación del producto (en días hábiles).
minHandlingTime

string (int64 format)

Tiempo mínimo de preparación del producto (en días hábiles).
shippingLabel

string

Es la etiqueta de envío del producto, que se usa para agrupar el producto en las reglas de envío a nivel de la cuenta.
transitTimeLabel

string

Es la etiqueta de tiempo en tránsito del producto, que se usa para agrupar productos en los tiempos en tránsito a nivel de la cuenta.
size

string

Es el tamaño del artículo. Solo se permite un valor. En el caso de las variantes con diferentes tamaños, inserta un producto distinto para cada tamaño con el mismo valor de itemGroupId (consulta [https://support.google.com/merchants/answer/6324492](definición de tamaño)).
sizeSystem

string

Es el sistema en el que se especifica el tamaño. Recomendado para artículos de indumentaria.
taxCategory

string

La categoría fiscal del producto, que se usa para configurar nexos fiscales detallados en la configuración de impuestos a nivel de la cuenta.
energyEfficiencyClass

string

Indica el nivel de eficiencia energética según se define en la directiva 2010/30/UE de la UE.
minEnergyEfficiencyClass

string

Indica el nivel de eficiencia energética según se define en la directiva 2010/30/UE de la UE.
maxEnergyEfficiencyClass

string

Indica el nivel de eficiencia energética según se define en la directiva 2010/30/UE de la UE.
multipack

string (int64 format)

Indica la cantidad de productos idénticos en un multipack definido por el comercio.
adsGrouping

string

Se usa para agrupar elementos de forma arbitraria. Solo para el porcentaje de CPA. En caso contrario, no se recomienda.
adsRedirect

string

Permite que los anunciantes anulen la URL del artículo cuando el producto se muestre en el contexto de los anuncios de productos.
displayAdsId

string

Es un identificador de un artículo para las campañas de remarketing dinámico.
displayAdsTitle

string

Es el título de un artículo para las campañas de remarketing dinámico.
displayAdsValue

number

Margen de oferta para las campañas de remarketing dinámico.
pickupMethod

string

Es la opción de retiro del artículo.
pickupSla

string

Cronograma de retiro en tienda del artículo
customLabel0

string

Etiqueta personalizada 0 para la agrupación personalizada de artículos en una campaña de Shopping.
customLabel1

string

Etiqueta personalizada 1 para la agrupación personalizada de artículos en una campaña de Shopping.
customLabel2

string

Etiqueta personalizada 2 para la agrupación personalizada de artículos en una campaña de Shopping.
customLabel3

string

Etiqueta personalizada 3 para agrupación personalizada de artículos en una campaña de Shopping.
customLabel4

string

Etiqueta personalizada 4 para la agrupación personalizada de artículos en una campaña de Shopping.
externalSellerId

string

Obligatorio para las cuentas de varios vendedores. Usa este atributo si representas a un mercado que sube productos para varios vendedores a tu cuenta de varios vendedores.
pause

string

Se pausará temporalmente la publicación de este elemento.
structuredTitle

object (ProductStructuredTitle)

Título estructurado, para títulos generados por algoritmos (IA).
structuredDescription

object (ProductStructuredDescription)

Descripción estructurada para descripciones generadas por algoritmos (IA).

Cuota

Un mensaje que representa una cuota.

Representación JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Campos
months

string (int64 format)

Indica la cantidad de cuotas que debe pagar el comprador.
amount

object (Price)

Es el importe mensual que debe pagar el comprador.
downpayment

object (Price)

Es el importe del pago inicial por adelantado que debe pagar el comprador.
creditType

string

El tipo de pago en cuotas. Los valores admitidos son los siguientes: * “finance” * “lease”

SubscriptionCost

El SubscriptionCost del producto.

Representación JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campos
period

enum (SubscriptionPeriod)

El tipo de período de suscripción. Los valores admitidos son los siguientes: * “month” * “year”
periodLength

string (int64 format)

Indica la cantidad de períodos de suscripción que debe pagar el comprador.
amount

object (Price)

Es el importe que debe pagar el comprador por período de suscripción.

SubscriptionPeriod

Es el período de suscripción del producto.

Enumeradores
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que el período de suscripción no se especifica.
MONTH Indica que el período de suscripción es mes.
YEAR Indica que el período de suscripción es año.

LoyaltyPoints

Un mensaje que representa los puntos de lealtad.

Representación JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Campos
name

string

Nombre del programa de puntos de lealtad. Se recomienda limitar el nombre a 12 caracteres de ancho completo o a 24 caracteres romanos.
pointsValue

string (int64 format)

Son los puntos de lealtad del minorista en valor absoluto.
ratio

number

La proporción que se usa para la conversión de un punto a una moneda. Google supone la moneda en función de la configuración de Merchant Center. Si no se incluye la proporción, el valor predeterminado es 1.0.

LoyaltyProgram

Un mensaje que representa el programa de lealtad.

Representación JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Campos
programLabel

string

Es la etiqueta del programa de lealtad. Es una etiqueta interna que identifica de manera inequívoca la relación entre una entidad comercial y una entidad del programa de lealtad. La etiqueta se debe proporcionar para que el sistema pueda asociar los activos que se indican a continuación (por ejemplo, precio y puntos) con un comercio. El programa correspondiente debe estar vinculado a la cuenta del comerciante.
tierLabel

string

Es la etiqueta del nivel dentro del programa de lealtad. Debe coincidir con una de las etiquetas del programa.
price

object (Price)

El precio para los miembros del nivel determinado, es decir, el precio con descuento instantáneo. Debe ser inferior o igual al precio normal.
cashbackForFutureUse

object (Price)

La devolución de dinero que se puede usar para compras futuras.
loyaltyPoints

string (int64 format)

Es la cantidad de puntos de lealtad que se obtuvieron por una compra.

ProductDimension

Es la dimensión del producto.

Representación JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Obligatorio. Es el valor de la dimensión representado como un número. El valor puede tener una precisión máxima de cuatro decimales.
unit

string

Obligatorio. Son las unidades de dimensión. Los valores aceptables son los siguientes: * “in” * “cm”

ProductWeight

Es el peso del producto.

Representación JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Obligatorio. Es el peso representado como número. La ponderación puede tener una precisión máxima de cuatro decimales.
unit

string

Obligatorio. La unidad de peso. Los valores aceptables son los siguientes: * "g" * "kg" * "oz" * "lb"

Envíos

Es el envío del producto.

Representación JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Campos
price

object (Price)

Es el precio de envío fijo, representado como un número.
country

string

Es el código de territorio de CLDR del país al que se enviará un artículo.
region

string

La región geográfica a la que se aplica una tarifa de envío. Consulta region para obtener más información.
service

string

Una descripción sin formato de la clase de servicio o la velocidad de entrega.
locationId

string (int64 format)

El ID numérico de una ubicación a la que se aplica la tarifa de envío, según se define en la API de AdWords.
locationGroupName

string

Es la ubicación en la que se aplica el envío, representada por el nombre de un grupo por ubicación.
postalCode

string

El intervalo de códigos postales al que se aplica la tarifa de envío, representado por un código postal, un prefijo de código postal seguido de un comodín *, un intervalo entre dos códigos postales o dos prefijos de códigos postales de igual longitud.
minHandlingTime

string (int64 format)

Tiempo de preparación mínimo (incluido) entre el momento en que se recibe el pedido y se envía en días hábiles. 0 significa que el pedido se envía el mismo día en que se recibe si se realiza antes del horario límite. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] solo puede estar presente junto con [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time]; pero no es obligatorio si [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] está presente.
maxHandlingTime

string (int64 format)

Tiempo de preparación máximo (incluido) entre el momento en que se recibe el pedido y se envía en días hábiles. 0 significa que el pedido se envía el mismo día en que se recibe si se realiza antes del horario límite. Los atributos [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] y [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] son obligatorios para proporcionar velocidades de envío. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] es opcional si [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] está presente.
minTransitTime

string (int64 format)

Tiempo mínimo en tránsito (incluido) entre el momento en que se envía el pedido y su entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] solo puede estar presente junto con [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]; pero no es obligatorio si [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] está presente.
maxTransitTime

string (int64 format)

Tiempo máximo en tránsito (incluido) entre el momento en que se envía el pedido y su entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. Los atributos [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] y [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] son obligatorios para proporcionar velocidades de envío. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] es opcional si [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] está presente.

FreeShippingThreshold

Son las condiciones que se deben cumplir para que un producto tenga envío gratis.

Representación JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Campos
country

string

Es el código de territorio de CLDR del país al que se enviará un artículo.
priceThreshold

object (Price)

El precio mínimo del producto para que el costo de envío sea gratuito. Se representa como un número.

ShippingWeight

Indica el ShippingWeight del producto.

Representación JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Es el peso del producto que se utiliza para calcular el costo de envío del artículo.
unit

string

Es la unidad de valor.

ShippingDimension

Es la dimensión ShippingDimension del producto.

Representación JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Es la dimensión del producto que se usa para calcular el costo de envío del artículo.
unit

string

Es la unidad de valor.

Impuesto

Indica el impuesto del producto.

Representación JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Campos
rate

number

Es el porcentaje de la tasa impositiva que se aplica al precio del artículo.
country

string

Indica el país en el que se aplican impuestos al artículo, que se especifica como un código de territorio CLDR.
region

string

La región geográfica a la que se aplica la tasa impositiva.
taxShip

boolean

Se establece como verdadero si se cobran impuestos sobre el envío.
locationId

string (int64 format)

El ID numérico de una ubicación a la que se aplica la tasa impositiva, según se define en la API de AdWords.
postalCode

string

El rango de códigos postales al que se aplica la tasa impositiva, representado por un código postal, un prefijo de código postal con el comodín *, un rango entre dos códigos postales o dos prefijos de códigos postales de igual longitud. Ejemplos: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

Es el valor de UnitPricingMedida del producto.

Representación JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

Es la medida de un artículo.
unit

string

Es la unidad de medida.

UnitPricingBaseMeasure

El UnitPricingBaseMedida del producto.

Representación JSON 
{
  "value": string,
  "unit": string
}
Campos
value

string (int64 format)

Es el denominador del precio unitario.
unit

string

La unidad del denominador.

ProductDetail

Son los detalles del producto.

Representación JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Campos
sectionName

string

El encabezado de sección que se usa para agrupar un conjunto de detalles del producto.
attributeName

string

Es el nombre de los detalles del producto.
attributeValue

string

El valor de los detalles del producto.

CloudExportAdditionalProperties

Propiedad del producto para la API de Cloud Retail. Por ejemplo, las propiedades de un producto de TV podrían ser "Resolución de pantalla" o "Tamaño de pantalla".

Representación JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Campos
textValue[]

string

Es el valor de texto de la propiedad determinada. Por ejemplo, "8K(UHD)" podría ser un valor de texto para un producto de TV. La repetición máxima de este valor es 400. Los valores se almacenan en un orden arbitrario pero coherente. El tamaño máximo de la cadena es de 256 caracteres.
intValue[]

string (int64 format)

Son los valores de número entero de la propiedad determinada. Por ejemplo, 1080 para la resolución de pantalla de un producto de TV. La repetición máxima de este valor es 400. Los valores se almacenan en un orden arbitrario pero coherente.
floatValue[]

number

Valores flotantes de la propiedad determinada. Por ejemplo, para el producto de TV 1.2345. La repetición máxima de este valor es 400. Los valores se almacenan en un orden arbitrario pero coherente.
propertyName

string

Es el nombre de la propiedad determinada. Por ejemplo, "Resolución de pantalla" para un producto de TV. El tamaño máximo de la cadena es de 256 caracteres.
boolValue

boolean

Valor booleano de la propiedad determinada. Por ejemplo, para un producto de TV, la opción "Verdadero" o "Falso" si la pantalla está en UHD
minValue

number

Valor flotante mínimo de la propiedad determinada. Por ejemplo, para un producto de TV 1.00.
maxValue

number

El valor flotante máximo de la propiedad determinada. Por ejemplo, para un producto de TV, 100.00.
unitCode

string

Unidad de la propiedad determinada. Por ejemplo, "Píxeles" para un producto de TV. El tamaño máximo de la cadena es de 256 B.

Certificación

La certificación del producto, que se presentó inicialmente para el cumplimiento del etiquetado de eficiencia energética de la UE, a través de la base de datos de EPREL de la UE

Representación JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Campos
certificationAuthority

string

Es la autoridad certificadora, por ejemplo, “Europe_Commission”. La longitud máxima es de 2,000 caracteres.
certificationName

string

Es el nombre de la certificación, por ejemplo, “EPREL”. La longitud máxima es de 2,000 caracteres.
certificationCode

string

El código de certificación La longitud máxima es de 2,000 caracteres.
certificationValue

string

El valor de la certificación (también conocido como clase, nivel o grado); por ejemplo, “A+”, “C” o “oro”. La longitud máxima es de 2,000 caracteres.

ProductStructuredTitle

Título estructurado, para títulos generados por algoritmos (IA).

Representación JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campos
digitalSourceType

string

El tipo de fuente digital, por ejemplo, “trained_algorithmic_media”, Sigue las indicaciones de IPTC. La longitud máxima es de 40 caracteres.
content

string

El texto del título tiene una longitud máxima de 150 caracteres.

ProductStructuredDescription

Descripción estructurada para descripciones generadas por algoritmos (IA).

Representación JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campos
digitalSourceType

string

El tipo de fuente digital, por ejemplo, “trained_algorithmic_media”, Sigue las indicaciones de IPTC. La longitud máxima es de 40 caracteres.
content

string

El texto descriptivo tiene una longitud máxima de 5,000 caracteres

ProductStatus

El estado de un producto, problemas de validación de datos, es decir, información sobre un producto calculada de forma asíncrona.

Representación JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Campos
destinationStatuses[]

object (DestinationStatus)

Son los destinos previstos del producto.
itemLevelIssues[]

object (ItemLevelIssue)

Una lista de todos los problemas asociados con el producto.
creationDate

string (Timestamp format)

Es la fecha en la que se creó el elemento. Debe mostrarse en formato ISO 8601.
lastUpdateDate

string (Timestamp format)

Es la fecha en la que se actualizó el artículo por última vez. Debe mostrarse en formato ISO 8601.
googleExpirationDate

string (Timestamp format)

Indica la fecha de vencimiento del artículo. Debe mostrarse en formato ISO 8601.

DestinationStatus

Es el estado del destino del producto.

Representación JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campos
reportingContext

enum (ReportingContextEnum)

Es el nombre del contexto del informe.
approvedCountries[]

string

Lista de los códigos de país (ISO 3166-1 alpha-2) en los que se aprobó la oferta.
pendingCountries[]

string

Lista de códigos de país (ISO 3166-1 alpha-2) en los que la oferta está pendiente de aprobación.
disapprovedCountries[]

string

Lista de códigos de país (ISO 3166-1 alpha-2) en los que se rechazó la oferta.

ItemLevelIssue

El ItemLevelIssue del estado del producto.

Representación JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campos
code

string

Es el código de error del problema.
severity

enum (Severity)

Cómo afecta este problema a la publicación de la oferta.
resolution

string

Indica si el comercio puede resolver el problema.
attribute

string

El nombre del atributo, si el problema se debe a un solo atributo.
reportingContext

enum (ReportingContextEnum)

El contexto de la denuncia al que se aplica el problema.
description

string

Una descripción breve del problema en inglés.
detail

string

Una descripción detallada del problema en inglés.
documentation

string

La URL de una página web para ayudar a resolver este problema.
applicableCountries[]

string

Lista de códigos de país (ISO 3166-1 alpha-2) donde el problema se aplica a la oferta.

Gravedad

Cómo afecta el problema a la publicación del producto

Enumeradores
SEVERITY_UNSPECIFIED No se especifica.
NOT_IMPACTED Este problema representa una advertencia y no tiene un efecto directo en el producto.
DEMOTED El producto desciende de nivel y es probable que tenga un rendimiento limitado en los resultados de la búsqueda
DISAPPROVED El problema rechaza el producto.

Métodos

get

 Recupera el producto procesado de su cuenta de Merchant Center.

list

 Muestra una lista de los productos procesados en tu cuenta de Merchant Center.