Package google.shopping.merchant.products.v1beta

Índice

ProductInputsService

Es el servicio que usa el recurso ProductInput. Este servicio solo funciona para productos con canal en línea.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

Borra una entrada de producto de tu cuenta de Merchant Center.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Sube una entrada de producto a tu cuenta de Merchant Center. Si ya existe una entrada con el mismo contentLanguage, offerId y dataSource, este método reemplaza esa entrada.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

Servicio de productos

Es el servicio que usa el recurso de producto. Este servicio solo funciona para productos con canal en línea.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Recupera el producto procesado de tu cuenta de Merchant Center.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto final actualizado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

Muestra una lista de los productos procesados en tu cuenta de Merchant Center. Es posible que la respuesta contenga menos elementos que los especificados por pageSize. Usa pageToken para determinar si hay más elementos que se pueden solicitar.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado actualizado.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/content

Para obtener más información, consulta OAuth 2.0 Overview.

Atributos

Atributos

Campos
expiration_date

Timestamp

Es la fecha en la que el artículo debe vencer, como se especifica cuando se inserta, en formato ISO 8601. La fecha de vencimiento real se expone en productstatuses como googleExpirationDate y puede ser anterior si expirationDate es demasiado lejana.
disclosure_date

Timestamp

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

Timestamp

Es el día en que un producto pedido por adelantado está disponible para su entrega, en formato ISO 8601.
gtin[]

string

Códigos comerciales globales de artículo (GTIN) del artículo Puedes proporcionar hasta 10 GTIN.
price

Price

Precio del artículo.
installment

Installment

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

SubscriptionCost

Es la cantidad de períodos (meses o años) y el importe del pago por período de un artículo con un contrato de suscripción asociado.
loyalty_points

LoyaltyPoints

Son los puntos de lealtad que los usuarios reciben después de comprar el artículo. Solo en Japón.
loyalty_programs[]

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étera) al usuario de este artículo.
product_types[]

string

Son las categorías del artículo (con el formato que se indica en las especificaciones de datos de productos).
sale_price

Price

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

Interval

Es el período durante el cual el artículo está en oferta (consulta las especificaciones de datos de productos).
product_height

ProductDimension

Es la altura del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido).
product_length

ProductDimension

Es la longitud del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido).
product_width

ProductDimension

Es el ancho del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 3,000 (incluido).
product_weight

ProductWeight

Es el peso del producto en las unidades proporcionadas. El valor debe estar entre 0 (excluido) y 2,000 (incluido).
shipping[]

Shipping

Reglas de envío
free_shipping_threshold[]

FreeShippingThreshold

Condiciones que se deben cumplir para que un producto tenga envío gratis.
shipping_weight

ShippingWeight

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

ShippingDimension

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

ShippingDimension

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

ShippingDimension

Es la altura del artículo para el envío.
size_types[]

string

Es el corte del artículo. Se puede usar para representar tipos de tallas combinadas para artículos de ropa. Se pueden proporcionar dos tipos de tallas como máximo (consulta [https://support.google.com/merchants/answer/6324497](tipo de talla)).
taxes[]

Tax

Información fiscal
unit_pricing_measure

UnitPricingMeasure

La medida y la dimensión de un artículo.
unit_pricing_base_measure

UnitPricingBaseMeasure

Es la preferencia del denominador del precio unitario.
ads_labels[]

string

Es similar a ads_grouping, pero solo funciona en CPC.
cost_of_goods_sold

Price

Costo de bienes vendidos. Se usa para los informes de ganancias brutas.
product_details[]

ProductDetail

Especificaciones técnicas o detalles adicionales del producto
product_highlights[]

string

Son viñetas que describen los aspectos más destacados de un producto.
display_ads_similar_ids[]

string

Son recomendaciones especificadas por el anunciante.
promotion_ids[]

string

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

string

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

string

Es la lista de destinos que se excluirán de esta segmentación (corresponde a las casillas de verificación que no se marcaron en Merchant Center).
shopping_ads_excluded_countries[]

string

Es una lista de códigos de país (ISO 3166-1 alpha-2) para excluir la oferta del destino de los anuncios de Shopping. Los países de esta lista se quitan de los países configurados en la configuración de la fuente de datos.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

Campos adicionales para exportar al programa de Cloud para venta minorista.
certifications[]

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 Consulta el artículo del Centro de ayuda para obtener más información.
auto_pricing_min_price

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 garantiza que los descuentos en las ofertas de los comercios no disminuyan por debajo de este valor, lo que preserva el valor y la rentabilidad de la oferta.
sustainability_incentives[]

ProductSustainabilityIncentive

La lista de programas de incentivos de sustentabilidad.
identifier_exists

bool

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

bool

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

Título del artículo
description

string

Descripción del artículo
adult

bool

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

string

Es el grupo etario objetivo del artículo.
availability

string

Estado de disponibilidad del artículo.
brand

string

Marca del artículo
color

string

Es el color del artículo.
condition

string

Es el estado o la condición del artículo.
gender

string

Es el género objetivo del artículo.
google_product_category

string

Es la categoría de Google del artículo (consulta la taxonomía de productos de Google). Cuando se consulten 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.
item_group_id

string

Es el identificador que comparten todas las variantes del mismo producto.
material

string

Es 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).
sell_on_google_quantity

int64

Es la cantidad del producto que está disponible para vender en Google. Solo es compatible con los productos en línea.
max_handling_time

int64

Es el tiempo máximo de preparación de los productos (en días hábiles).
min_handling_time

int64

Es el tiempo mínimo de preparación del producto (en días hábiles).
shipping_label

string

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

string

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

string

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

string

Es el sistema en el que se especifica el tamaño. Se recomienda para artículos de indumentaria.
tax_category

string

Es la categoría fiscal del producto.
energy_efficiency_class

string

Es el nivel de eficiencia energética definido en la Directiva 2010/30/UE de la UE.
min_energy_efficiency_class

string

Es el nivel de eficiencia energética definido en la Directiva 2010/30/UE de la UE.
max_energy_efficiency_class

string

Es el nivel de eficiencia energética definido en la Directiva 2010/30/UE de la UE.
multipack

int64

Es la cantidad de productos idénticos en un multipack definido por el comercio.
ads_grouping

string

Se usa para agrupar elementos de forma arbitraria. Solo para CPA%, no se recomienda en otros casos.
ads_redirect

string

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

string

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

string

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

double

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

string

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

string

Cronograma de retiro en tienda del artículo
custom_label_0

string

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

string

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

string

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

string

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

string

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

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

La publicación de este elemento se detendrá temporalmente.
structured_title

ProductStructuredTitle

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

ProductStructuredDescription

Descripción estructurada para descripciones generadas de forma algorítmica (IA).

Certificación

Certificación de productos, que se introdujo inicialmente para el cumplimiento del etiquetado de eficiencia energética de la UE con la base de datos del EPREL de la UE

Campos
certification_authority

string

La autoridad certificadora, por ejemplo, "European_Commission". La longitud máxima es de 2,000 caracteres.
certification_name

string

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

string

Es el código de certificación. La longitud máxima es de 2,000 caracteres.
certification_value

string

Es el valor de la certificación (también conocido como clase, nivel o calificación), por ejemplo, "A+", "C", "oro". La longitud máxima es de 2,000 caracteres.

CloudExportAdditionalProperties

Es la propiedad del producto para la API de Cloud Retail. Por ejemplo, las propiedades de un producto de TV podrían ser "Screen-Resolution" o "Screen-Size".

Campos
text_value[]

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 de 400. Los valores se almacenan en un orden arbitrario, pero coherente. El tamaño máximo de la cadena es de 256 caracteres.
int_value[]

int64

Valores enteros 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.
float_value[]

float

Valores de número de punto flotante de la propiedad determinada. Por ejemplo, para un 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.
property_name

string

Es el nombre de la propiedad determinada. Por ejemplo, "Screen-Resolution" para un producto de TV. El tamaño máximo de la cadena es de 256 caracteres.
bool_value

bool

Es el valor booleano de la propiedad determinada. Por ejemplo, para un producto de TV, "Verdadero" o "Falso" si la pantalla es UHD.
min_value

float

Es el valor mínimo de número de punto flotante de la propiedad determinada. Por ejemplo, para un producto de TV, 1.00.
max_value

float

Es el valor máximo de número de punto flotante de la propiedad determinada. Por ejemplo, para un producto de TV, 100.00.
unit_code

string

Es la unidad de la propiedad determinada. Por ejemplo, “Pixels” para un producto de TV. El tamaño máximo de la cadena es de 256 B.

DeleteProductInputRequest

Mensaje de solicitud para el método DeleteProductInput.

Campos
name

string

Es obligatorio. Es el nombre del recurso de entrada de productos que se borrará. Formato: accounts/{account}/productInputs/{product}, en el que la última sección product consta de 4 partes: channel~content_language~feed_label~offer_id. Un ejemplo de nombre de producto es "accounts/123/productInputs/online~en~US~sku123".
data_source

string

Es obligatorio. Es la fuente de datos principal o complementaria de la que se debe borrar la entrada de productos. Formato: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Condiciones que se deben cumplir para que un producto tenga envío gratis.

Campos
country

string

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

Price

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

GetProductRequest

Mensaje de solicitud para el método GetProduct.

Campos
name

string

Es obligatorio. Es el nombre del producto que se recuperará. Formato: accounts/{account}/products/{product}, en el que la última sección product consta de 4 partes: channel~content_language~feed_label~offer_id. Un ejemplo de nombre de producto es "accounts/123/products/online~en~US~sku123".

InsertProductInputRequest

Mensaje de solicitud para el método InsertProductInput.

Campos
parent

string

Es obligatorio. Es la cuenta en la que se insertará este producto. Formato: accounts/{account}
product_input

ProductInput

Es obligatorio. Es la entrada del producto que se insertará.
data_source

string

Es obligatorio. Es el nombre de la fuente de datos de productos principal o complementaria. Si el producto ya existe y la fuente de datos proporcionada es diferente, el producto se moverá a una fuente de datos nueva.

Solo se admiten fuentes de datos de API.

Formato: accounts/{account}/dataSources/{datasource}.

Cuota

Es un mensaje que representa una cuota.

Campos
months

int64

Es la cantidad de cuotas en las que el comprador debe efectuar el pago.
amount

Price

Es el importe que el comprador debe pagar por mes.
downpayment

Price

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

string

Tipo de pagos en cuotas. Los valores admitidos son los siguientes: * "finance" * "lease"

ListProductsRequest

Mensaje de solicitud para el método ListProducts.

Campos
parent

string

Es obligatorio. Es la cuenta para la que se mostrarán los productos procesados. Formato: accounts/{account}
page_size

int32

Es la cantidad máxima de productos que se mostrarán. El servicio puede mostrar menos que este valor. El valor máximo es 250; los valores superiores a 250 se convertirán a 250. Si no se especifica, se mostrará la cantidad máxima de productos.
page_token

string

Un token de página, recibido desde una llamada ListProducts anterior. Proporciona esto para recuperar la página siguiente.

Cuando se pagina, todos los demás parámetros proporcionados a ListProducts deben coincidir con la llamada que proporcionó el token de la página.

ListProductsResponse

Mensaje de respuesta para el método ListProducts.

Campos
products[]

Product

Son los productos procesados de la cuenta especificada. Estos son los productos procesados después de aplicar reglas y fuentes de datos complementarias.
next_page_token

string

Un token, que se puede enviar como page_token para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

LoyaltyPoints

Un mensaje que representa puntos de lealtad.

Campos
name

string

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

int64

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

double

Es la proporción que se usa para convertir un punto en moneda. Google supone la moneda según la configuración de Merchant Center. Si no se incluye la proporción, el valor predeterminado es 1.0.

LoyaltyProgram

Es un mensaje que representa el programa de lealtad.

Campos
program_label

string

Es la etiqueta del programa de lealtad. Es una etiqueta interna que identifica de forma exclusiva la relación entre una entidad de comercio y una entidad de programa de lealtad. Se debe proporcionar la etiqueta para que el sistema pueda asociar los recursos que se indican a continuación (por ejemplo, el precio y los puntos) con un comercio. El programa correspondiente debe estar vinculado a la cuenta del comerciante.
tier_label

string

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

Price

Es el precio para los miembros del nivel determinado, es decir, el precio con descuento instantáneo. Debe ser menor o igual que el precio normal.
cashback_for_future_use

Price

El reembolso que se puede usar para compras futuras.
loyalty_points

int64

Es la cantidad de puntos de lealtad que se obtienen en una compra.
member_price_effective_date

Interval

Es un período durante el cual el artículo es apto para el precio para miembros. Si no se especifica, siempre se aplica el precio para miembros. El período se representa con un par de fechas ISO 8601 separadas por un espacio, una coma o una barra diagonal.
shipping_label

string

Es la etiqueta del beneficio de envío. Si el campo tiene un valor, esta oferta tiene un beneficio de envío mediante programas de lealtad. Si no se proporciona el valor del campo, el artículo no es apto para el envío mediante programas de lealtad para el nivel de lealtad determinado.

Producto

El producto procesado, creado a partir de varios product inputs 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, en los anuncios de Shopping y en otras plataformas de Google. Cada producto se crea a partir de exactamente una entrada de producto de la fuente de datos principal y varias entradas de fuentes de datos complementarias. Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado actualizado.

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

Campos
name

string

Es el nombre del producto. Formato: "{product.name=accounts/{account}/products/{product}}", en el que la última sección product consta de 4 partes: channel~content_language~feed_label~offer_id. Un ejemplo de nombre de producto es "accounts/123/products/online~en~US~sku123".
channel

ChannelEnum

Solo salida. Es el canal del producto.
offer_id

string

Solo salida. Es tu identificador único para el producto. Esto es igual para la entrada del producto y el producto procesado. Los espacios en blanco iniciales y finales se quitan, y los espacios en blanco múltiples se reemplazan por un solo espacio en blanco cuando se envía el contenido. Consulta las especificaciones de datos de productos para obtener más detalles.
content_language

string

Solo salida. Es el código de idioma ISO 639-1 de dos letras del producto.
feed_label

string

Solo salida. Es la etiqueta del feed del producto.
data_source

string

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

Attributes

Solo salida. Es una lista de atributos del producto.
custom_attributes[]

CustomAttribute

Solo salida. Es una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de la especificación de datos en su forma genérica (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.
product_status

ProductStatus

Solo salida. El estado de un producto, los problemas de validación de datos, es decir, la información sobre un producto que se calcula de forma asíncrona.
version_number

int64

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

Si se establece, se evita la inserción cuando el número de versión es inferior al número de versión actual del producto existente. La inserción nuevamente (por ejemplo, la actualización de productos después de 30 días) se puede realizar con el version_number actual.

Solo se admite para inserciones en fuentes de datos principales.

Si se evita la operación, se arrojará la excepción abortada.

ProductDetail

Los detalles del producto.

Campos
section_name

string

Es el encabezado de la sección que se usa para agrupar un conjunto de detalles del producto.
attribute_name

string

Es el nombre del detalle del producto.
attribute_value

string

Es el valor del detalle del producto.

ProductDimension

Es la dimensión del producto.

Campos
value

double

Es 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

Es obligatorio. Las unidades de dimensión. Los valores aceptables son: * "in" * "cm"

ProductInput

Este recurso representa los datos de entrada que envías para un producto, no el producto procesado que ves en Merchant Center, en los anuncios de Shopping ni en las plataformas de Google. Las entradas de productos, las reglas y los datos de la fuente de datos complementaria se combinan para crear el Product procesado.

Los atributos de entrada de productos obligatorios para aprobar las verificaciones de validación de datos se definen principalmente en las especificaciones de datos de productos.

Se requieren los siguientes atributos: feedLabel, contentLanguage y offerId.

Después de insertar, actualizar o borrar una entrada de producto, es posible que debas esperar varios minutos para poder recuperar el producto procesado.

Todos los campos de la entrada del producto y sus submensajes coinciden con el nombre en inglés de su atributo correspondiente en las especificaciones verticales, con algunas excepciones.

Campos
name

string

Identificador. Es el nombre de la entrada del producto. Formato: "{productinput.name=accounts/{account}/productInputs/{productinput}}", en el que la última sección productinput consta de 4 partes: channel~content_language~feed_label~offer_id. Un ejemplo de nombre de entrada de producto es "accounts/123/productInputs/online~en~US~sku123".
product

string

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

ChannelEnum

Inmutable. Es el canal del producto.
offer_id

string

Es obligatorio. Inmutable. Es tu identificador único para el producto. Esto es igual para la entrada del producto y el producto procesado. Los espacios en blanco iniciales y finales se quitan, y los espacios en blanco múltiples se reemplazan por un solo espacio en blanco cuando se envía el contenido. Consulta las especificaciones de datos de productos para obtener más información.
content_language

string

Es obligatorio. Inmutable. Es el código de idioma ISO 639-1 de dos letras del producto.
feed_label

string

Es obligatorio. Inmutable. La etiqueta del feed del producto.
attributes

Attributes

Opcional. Es una lista de atributos del producto.
custom_attributes[]

CustomAttribute

Opcional. Es una lista de atributos personalizados (proporcionados por el comercio). También se puede usar para enviar cualquier atributo de la especificación de datos en su forma genérica (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. La cantidad máxima de caracteres permitida para cada atributo personalizado es de 10,240 (representa la suma de caracteres para el nombre y el valor). Se pueden establecer un máximo de 2,500 atributos personalizados por producto, con un tamaño total de 102.4 KB. Los guiones bajos en los nombres de atributos personalizados se reemplazan por espacios cuando se insertan.
version_number

int64

Opcional. Representa la versión existente (actualización) del producto, que se puede usar para preservar el orden correcto cuando se realizan varias actualizaciones al mismo tiempo.

Si se establece, se evita la inserción cuando el número de versión es inferior al número de versión actual del producto existente. La inserción nuevamente (por ejemplo, la actualización de productos después de 30 días) se puede realizar con el version_number actual.

Solo se admite para inserciones en fuentes de datos principales.

Si se evita la operación, se arrojará la excepción abortada.

ProductStatus

El estado de un producto, los problemas de validación de datos, es decir, la información sobre un producto que se calcula de forma asíncrona.

Campos
destination_statuses[]

DestinationStatus

Los destinos objetivos para el producto.
item_level_issues[]

ItemLevelIssue

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

Timestamp

Es la fecha en la que se creó el elemento, en formato ISO 8601.
last_update_date

Timestamp

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

Timestamp

Es la fecha en la que vence el artículo, en formato ISO 8601.

DestinationStatus

Es el estado de destino del estado del producto.

Campos
reporting_context

ReportingContextEnum

Es el nombre del contexto de informes.
approved_countries[]

string

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

string

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

string

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

ItemLevelIssue

Es el ItemLevelIssue del estado del producto.

Campos
code

string

El código de error del problema.
severity

Severity

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

string

Si el comercio puede resolver el problema.
attribute

string

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

ReportingContextEnum

Es el contexto de informes al que se aplica el problema.
description

string

Una breve descripción 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
applicable_countries[]

string

Es la lista de códigos de país (ISO 3166-1 alpha-2) en los que el problema se aplica a la oferta.

Gravedad

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

Enumeraciones
SEVERITY_UNSPECIFIED No se especifica.
NOT_IMPACTED Este problema representa una advertencia y no tiene un efecto directo en el producto.
DEMOTED El producto se degrada y, lo más probable, es que tenga un rendimiento limitado en los resultados de la búsqueda.
DISAPPROVED El problema rechaza el producto.

ProductStructuredDescription

Descripción estructurada para descripciones generadas de forma algorítmica (IA).

Campos
digital_source_type

string

Es el tipo de fuente digital, por ejemplo, "trained_algorithmic_media". Sigue los lineamientos del IPTC. La longitud máxima es de 40 caracteres.
content

string

La longitud máxima del texto de la descripción es de 5,000 caracteres.

ProductStructuredTitle

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

Campos
digital_source_type

string

Es el tipo de fuente digital, por ejemplo, "trained_algorithmic_media". Sigue los lineamientos del IPTC. La longitud máxima es de 40 caracteres.
content

string

La longitud máxima del texto del título es de 150 caracteres.

ProductSustainabilityIncentive

Información sobre programas de incentivos relacionados con la sostenibilidad, como reembolsos o exenciones de impuestos

Campos
Campo de unión value. Valor del incentivo de sustentabilidad Las direcciones (value) solo pueden ser una de las siguientes opciones:
amount

Price

Es el importe fijo del incentivo.
percentage

double

Es el porcentaje del precio de oferta al que se aplica el incentivo.
type

Type

Programa de incentivos de sustentabilidad

Tipo

Tipos de programas de incentivos de sostenibilidad admitidos.

Enumeraciones
TYPE_UNSPECIFIED Tipo de incentivo de sostenibilidad no especificado o desconocido.
EV_TAX_CREDIT Programa que ofrece reducciones de responsabilidad fiscal para los vehículos eléctricos y, en algunos países, los híbridos enchufables. Estas reducciones pueden basarse en un importe específico o en un porcentaje del precio de oferta.
EV_PRICE_DISCOUNT Un programa de subsidios, a menudo llamado bonificación ambiental, proporciona un subsidio de compra para vehículos eléctricos y, en algunos países, híbridos enchufables. El importe de la subvención puede ser una suma fija o un porcentaje del precio de oferta.

ProductWeight

Es el peso del producto.

Campos
value

double

Es obligatorio. El peso representado como un número. El peso puede tener una precisión máxima de cuatro decimales.
unit

string

Es obligatorio. La unidad de peso. Los valores aceptables son: * "g" * "kg" * "oz" * "lb"

Envío

El envío del producto.

Campos
price

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

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

string

Una descripción de formato libre del tipo de servicio o la velocidad de entrega.
location_id

int64

Es 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.
location_group_name

string

La ubicación donde se aplica el envío, representada por un nombre de grupo por ubicación.
postal_code

string

Es 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ódigo postal de la misma longitud.
min_handling_time

int64

Es el tiempo de preparación mínimo (inclusive) entre el momento en que se recibe el pedido y el momento en que 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 esto ocurre antes de la hora límite. minHandlingTime solo puede estar presente junto con maxHandlingTime, pero no es obligatorio si maxHandlingTime está presente.
max_handling_time

int64

Es el tiempo de preparación máximo (inclusive) entre el momento en que se recibe el pedido y el momento en que 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 esto ocurre antes de la hora límite. Se requieren maxHandlingTime y maxTransitTime si proporcionas velocidades de envío. minHandlingTime es opcional si maxHandlingTime está presente.
min_transit_time

int64

Es el tiempo mínimo en tránsito (inclusive) entre el momento en que se envía el pedido y el momento en que se entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. minTransitTime solo puede estar presente junto con maxTransitTime, pero no es obligatorio si maxTransitTime está presente.
max_transit_time

int64

Es el tiempo máximo en tránsito (inclusive) entre el momento en que se envía el pedido y el momento en que se entrega en días hábiles. 0 significa que el pedido se entrega el mismo día en que se envía. Se requieren maxHandlingTime y maxTransitTime si proporcionas velocidades de envío. minTransitTime es opcional si maxTransitTime está presente.

ShippingDimension

Es la ShippingDimension del producto.

Campos
value

double

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.

ShippingWeight

Es el atributo ShippingWeight del producto.

Campos
value

double

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

string

La unidad de valor.

SubscriptionCost

Es el SubscriptionCost del producto.

Campos
period

SubscriptionPeriod

Es el tipo de período de suscripción. Los valores admitidos son: * "month" * "year"
period_length

int64

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

Price

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

SubscriptionPeriod

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

Enumeraciones
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que no se especificó el período de suscripción.
MONTH Indica que el período de la suscripción es mensual.
YEAR Indica que el período de suscripción es de un año.

Impuesto

Es el impuesto del producto.

Campos
rate

double

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

string

Es el país en el que se grava el artículo, especificado como un código de territorio de CLDR.
region

string

Es la región geográfica a la que se aplica la tasa impositiva.
tax_ship

bool

Establece como verdadero si se cobra un impuesto sobre el envío.
location_id

int64

Es 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.
postal_code

string

Es el intervalo 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 intervalo entre dos códigos postales o dos prefijos de código postal de la misma longitud. Ejemplos: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

Es la UnitPricingBaseMeasure del producto.

Campos
value

int64

Es el denominador del precio unitario.
unit

string

Es la unidad del denominador.

UnitPricingMeasure

Es la UnitPricingMeasure del producto.

Campos
value

double

Es la medida de un artículo.
unit

string

La unidad de la medida.