Notas de la versión (v2.1)

18 de agosto de 2025

La API de Content está obsoleta y se dará de baja en agosto de 2026. Migra a la API de Merchant

19 de junio de 2025

Servicio de productos

Recurso del producto

Se agregó el campo maximum_retail_price para permitir la especificación del precio de venta máximo (MRP) en la India.

Servicio de asistencia para comercios

26 de mayo de 2025

Servicio de cuentas

Ahora es posible agregar usuarios con acceso de lectura a las cuentas.

14 de abril de 2025

Servicio de cuentas

Como ya no será un requisito en el futuro, el servicio accounttax dejó de estar disponible.

17 de marzo de 2025

Como parte del cierre de las APIs relacionadas con pedidos, se dejaron de usar los siguientes servicios:

  • accounts.verifyphonenumber
  • returnpolicy

Otros servicios

Este extremo ya no es necesario y se puede marcar como no disponible:

  • pubsubnotificationsettings

10 de feb de 2025

Se agregaron campos prerendered_out_of_court_dispute_settlement a ProductIssue y a AccountIssue.

Se dieron de baja los campos alternate_dispute_resolution de RenderProductIssuesResponse y RenderAccountIssuesResponse.

12 de dic de 2024

Servicio de productos

Se agregó el campo sustainability_incentives para especificar incentivos de sustentabilidad, como créditos fiscales o descuentos en el precio de tus productos. Si no se proporciona el valor del campo, el artículo no es apto para ningún incentivo de sustentabilidad.

15 de noviembre de 2024

Servicio de productos

Para LoyaltyProgram, se agregó el campo shipping_label para especificar la elegibilidad. Si el campo tiene un valor, esta oferta tiene un beneficio de envío por lealtad. Si no se proporciona el valor del campo, el artículo no es apto para el envío con beneficios de lealtad para el nivel de lealtad determinado.

30 de octubre de 2024

Como parte del cierre de las APIs relacionadas con la liquidación, se dejaron de usar los siguientes servicios:

  • settlementreports
  • settlementtranscations

El cierre de las APIs relacionadas con la liquidación se vincula con el cierre anterior del programa BuyOnGoogle y las APIs relacionadas con los pedidos.

Se espera que las llamadas a los servicios mencionados anteriormente fallen con una respuesta Service was not found on the server.

16 de octubre de 2024

update_mask en UpdateConversionSourceRequest ahora es OPTIONAL. Si no se especifica una máscara de actualización, se actualizarán todos los campos que tengan un valor no vacío.

26 de agosto de 2024 (antes de lo que se había comunicado originalmente)

Como parte del cierre de las APIs relacionadas con pedidos, se dejaron de usar los siguientes servicios:

  • orderinvoices
  • orderreports
  • orderreturns
  • orderreturns.labels
  • orders

Se espera que las llamadas a los servicios mencionados anteriormente fallen con una respuesta Service was not found on the server.

El servicio OrderTrackingSignals no está en desuso y sigue estando disponible.

10 de agosto de 2024

Servicios de Comprar con Google

Como parte del cierre de las APIs de Comprar con Google, todos los métodos dentro de BuyOnGoogleProgramService fallarán con service was not found on the server.

19 de julio de 2024

Servicio de productos

Se agregó el campo member_price_effective_date. Esta actualización te permite especificar, si corresponde, el período durante el que el precio para miembros del programa de lealtad está vigente. Si no se proporciona el valor del campo, el precio para miembros siempre será efectivo.

20 de mayo de 2024

Servicio de productos

Se agregó LoyaltyPrograms. Esta actualización te permite proporcionar varios niveles con diferentes puntos de lealtad, precios, etcétera para un solo producto. Debes usar este campo en lugar del campo singular LoyaltyProgram.

Servicio de informes

Son las métricas de Comprar con Google que dejaron de estar disponibles en la tabla MerchantPerformanceView. Después de esta actualización, recuperar cualquier métrica de Comprar con Google devolverá 0. Esto también se aplica a los valores históricos de fechas anteriores.

Para obtener más información, consulta Baja de Comprar con Google.

13 de mayo de 2024

Servicio de productos

Recurso del producto

Cambios en el campo de certificaciones: Se agregó certificationValue al campo ProductCertification para proporcionar el valor de certificación (también conocido como clase, nivel o grado), lo que permite a los usuarios subir información de certificación incluso si la autoridad de certificación no emite un código o número de certificación.

Para obtener más información, consulta nuestras guías de productos.

6 de mayo de 2024

Servicio de informes

Se agregó el bucket de efectividad a la tabla PriceInsightsProductView. La eficacia indica qué productos se beneficiarían más de los cambios de precio. En esta calificación, se tiene en cuenta el aumento del rendimiento que se predice ajustando el precio de oferta y la diferencia entre tu precio actual y el precio sugerido.

24 de abril de 2024

Servicio de productos

Recurso del producto

Se agregaron los campos opcionales downpayment y creditType para los pagos en cuotas:

  • downpayment proporciona el importe que el comprador debe pagar por adelantado como un pago único.
  • creditType proporciona el tipo de pago en cuotas (finance o lease). Este campo solo se aplica a los anuncios de vehículos.

11 de abril de 2024

Servicio de productos

Recurso del producto

  • Se agregó el atributo umbral de envío gratis (FreeShippingThreshold) para el envío a nivel de la oferta. Este atributo permite que los comercios ingresen un precio mínimo del producto para que el costo de envío sea gratis.
  • Se cambió la visibilidad de LoyaltyPoints

10 de abril de 2024

Servicio de productos

Recurso del producto

Se agregó LoyaltyProgram

9 de abril de 2024

Servicio de productos

Recurso del producto

Se agregaron structuredTitle y structuredDescription para proporcionar títulos y descripciones de productos generados por IA.

3 de abril de 2024

Servicio de asistencia para comercios

Se agregó el campo user_input_action_option que permite a los socios solicitar un nuevo tipo de acción: BuiltInUserInputAction. Esta acción permite que los socios creen funciones complejas de autoservicio para los comercios directamente en su aplicación, en lugar de redireccionarlos a Merchant Center.

Se agregó un nuevo método TriggerAction para BuiltInUserInputAction. Para acceder a este método, envía una solicitud a través de este formulario.

27 de marzo de 2024

Servicio de productos

Recurso del producto

Se agregó AutoPricingMinPrice como medida de protección en los proyectos "Descuentos automatizados" y "Promociones dinámicas", lo que garantiza que los descuentos en las ofertas de los comercios no reduzcan el precio del producto a un valor inferior a este. De esta manera, se preservan el valor y la rentabilidad de la oferta.

15 de marzo de 2024

Se descontinuó Comprar con Google para la Búsqueda y Shopping. Puedes seguir viendo los pedidos existentes hasta el 31 de octubre de 2024 con orders.list y orders.get.

8 de marzo de 2024

Servicio de informes

Se agregó el informe TopicTrendsView al servicio Reports.

Para obtener más información, consulta nuestras Guías de denuncias.

6 de marzo de 2024

Servicio de informes

Se agregaron el bucket y la clasificación del potencial de clics para los productos.

Para obtener más información, consulta nuestras Guías de denuncias.

19 de febrero de 2024

Servicio de ConversionSources

Se quitaron los siguientes valores como fuentes de conversiones válidas:

  • CROSS_CHANNEL_FIRST_CLICK
  • CROSS_CHANNEL_LINEAR
  • CROSS_CHANNEL_POSITION_BASED
  • CROSS_CHANNEL_TIME_DECAY

Se quitaron las opciones de 60 y 90 días como ventanas de visualización y se agregó 40 como una opción válida.

17 de enero de 2024

Servicio de PdV

Se agregaron valores nuevos para el campo matching_status_hint en PosStore, lo que permite que los usuarios tengan más detalles sobre por qué falló la correlación de su tienda.

11 de enero de 2024

Servicio de cuentas

Se agregaron localProductManager y localProductManagement como tipo de vínculo y servicio, respectivamente, para el método link. Estos vínculos permiten que las cuentas se vinculen con el propósito de administrar los datos de productos locales.

29 de noviembre de 2023

Servicio de asistencia para comercios

Se agregó el tipo de acción externa VERIFY_IDENTITY_IN_MERCHANT_CENTER para la verificación de identidad que se debe realizar en Merchant Center.

Servicio de PdV

Se agregaron los campos matching_status y matching_status_hint a PosStore, lo que permite a los usuarios conocer el estado de coincidencia de la tienda del PdV con la tienda del Perfil de Negocio de Google y obtener sugerencias para solucionar problemas.

15 de noviembre de 2023

Ya no se admiten los extremos repricingrules y repricingrules.repricingreports.

1 de noviembre de 2023

Servicio de configuración de envío

Ya no se admite shipment_type=pickup.

18 de octubre de 2023

Servicio de cuentas

Se agregó el campo Business Identity, que permite a los comercios identificarse con ciertos valores del consumidor.

10 de octubre de 2023

Se agregó Collection Point como un nuevo tipo de envío del servicio de configuración de envío. La entrega en punto de recolección es un servicio que proporciona un tercero (p.ej., no es propiedad del comercio) para entregar el artículo en una ubicación afiliada de un tercero (como los puntos de acceso de UPS), en lugar de entregarlo directamente en la casa.

18 de septiembre de 2023

Servicio de configuración de LIA

Se agregó el método setOmnichannelExperience para permitir que los usuarios configuren su experiencia omnicanal (es decir, la configuración de la tienda local y el retiro). Por el momento, esta opción solo está disponible para los usuarios cuyo proveedor de POS es de confianza para habilitar estos parámetros de configuración.

7 de septiembre de 2023

Baja de Comprar con Google

Se agregó un nuevo estado DEPRECATED al método GetBuyOnGoogleProgramStastus. No es posible reactivar ni pausar el programa desde ese estado.

4 de septiembre de 2023

Servicio de asistencia para comercios

Se agregó la acción integrada FIX_ACCOUNT_ISSUE para los problemas relacionados con los productos que se deben resolver a nivel de la cuenta. Se agregó la acción integrada SHOW_ADDITIONAL_CONTENT que se usará para entregar una justificación de una autoridad nacional.

28 de agosto de 2023

Servicio de promociones

Se abrió el método list en el servicio Promotions, que pasó de tener acceso limitado a estar disponible para todos.

22 de agosto de 2023

Servicio de asistencia para comercios

Se lanzó el servicio de asistencia para comercios. Este servicio proporciona contenido de asistencia para problemas relacionados con la cuenta y con los productos.

4 de agosto de 2023

Servicio de informes

Se agregó el informe Visibilidad de competencia de la competencia cercana al servicio de Informes.

Para obtener más información, consulta nuestras Guías de denuncias.

25 de julio de 2023

Servicio de POS

Recurso de inventario

Se agregaron los campos pickup_method y pickup_sla para que los comercios puedan enviar información de retiro junto con su inventario.

14 de julio de 2023

Servicio de informes

Se agregaron informes de Visibilidad de competencia al servicio de Informes.

Para obtener más información, consulta nuestras Guías de denuncias.

7 de julio de 2023

Servicio de productos

Recurso del producto

Se agregó virtualModelLink para proporcionar URLs a la imagen del modelo 3D.

4 de julio de 2023

Servicio de productos

Recurso del producto

Se agregó el campo certifications para proporcionar certificaciones de productos, por ejemplo, para el etiquetado de eficiencia energética de productos según la base de datos de EPREL de la UE.

26 de junio de 2023

Servicio de configuración de envío

Entrega local

Se agregó el campo no_delivery_post_cutoff para permitir que los comercios inhabiliten la opción de mostrar la entrega local en el día siguiente (n+1) cuando tienen configurado un servicio de envío para la entrega local en el día (n).

29 de mayo de 2023

Servicio de promociones

Se agregó el método list para el servicio Promotions.

Servicio de recomendaciones

Habilita el descarte de interacciones en el método ReportInteraction del servicio de Recommendations.

9 de mayo de 2023

Destino de Cloud Retail

Propiedades adicionales de Cloud Retail

Agrega el campo de propiedades adicionales de venta minorista en la nube. Es un campo repetido que los clientes que usan el destino de Cloud Retail deben usar. Cuando se usa este campo, estará disponible cuando se use el programa de venta minorista en la nube. Este se asignará al campo de atributos en el modelo de producto de Google Cloud Retail.

22 de mayo de 2023

Servicio de promociones

Se agregó el método list para el servicio Promotions.

11 de abril de 2023

Servicio de configuración de envío

Entrega local

Se agregó la opción de preparación de pedidos de entrega local para los comercios que crean un nuevo parámetro de configuración de envío. Pueden configurar sus parámetros para las tiendas locales en el nuevo campo storeConfig. Esto incluye el radio de servicio, la hora límite y los códigos de las tiendas que ofrecen entrega local.

3 de abril

Servicio de recomendaciones

Se lanzó el servicio de recomendaciones. Este servicio proporciona sugerencias para mejorar el rendimiento de tu cuenta de comerciante y te permite informar los clics de los comerciantes en las recomendaciones útiles.

20 de febrero de 2023

Servicio de cuentas

Recurso de la cuenta

Se agregó una nueva sección Account.ConversionSettings en el recurso Accounts.

Servicio de ConversionSources

Se agregó el servicio Fuentes de conversiones, que permite administrar las fuentes de conversiones (parte de la sección Configuración de conversiones en Merchant Center).

16 de febrero de 2023

Servicio de configuración de envío

Validación del código de tienda

Ahora se validan los códigos de tienda para garantizar que pertenezcan al comercio antes de que se actualice la configuración de envío.

Validación de comercios de LIA

Ahora se validan los programas en los que se inscribe un ID de comerciante antes de que se actualice la configuración de envío. Los comercios deben participar en uno de los siguientes programas:

  • LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLE
  • LOCAL_INVENTORY_ADS

9 de feb, 2023

Servicio de promociones

Se expandió el servicio de Promociones a 6 opciones de targetCountry adicionales con asistencia local de contentLanguage:

  • BR
  • ES
  • NL
  • JP
  • IT
  • KR

12 de ene de 2023

Servicio de productos

Recurso del producto

Se agregó lifestyleImageLinks para proporcionar URLs a imágenes de estilo de vida.

24 de noviembre de 2022

Servicio de promoción

Se agregó un nuevo campo "promotionStatus" en la sección Promotions.PromotionStatus. Este campo es de solo lectura.

15 de noviembre de 2022

Servicio de informes

Se agregaron informes de Market Insights al servicio de Informes.

Ahora puedes consultar el servicio de Reports para obtener la siguiente información:

Para obtener más información, consulta nuestras Guías de denuncias.

7 de noviembre de 2022

Servicio de Feeds de datos

Se agregó compatibilidad con feedLabel para el servicio de Feeds de datos.

14 de septiembre de 2022

Se actualizó feedLabel para aceptar cualquier cadena.

9 de agosto de 2022

Se agregó feedLabel para los productos.

Ahora puedes usar feedLabel en lugar de targetCountry para especificar el país de los IDs de oferta. Ahora, los IDs de ofertas se construyen como online:language:feedLabel:offerId.

feedLabel se propagó automáticamente con tu valor de targetCountry para los feeds existentes por motivos de retrocompatibilidad.

targetCountry quedó obsoleto.

Para admitir ofertas globales, Content API for Shopping dejó de utilizar el campo targetCountry. En su lugar, te recomendamos que uses el campo shipping para especificar los países objetivo.

targetCountry ahora se propaga automáticamente con el valor que proporcionas en feedLabel.

Consulta la entrada del blog La etiqueta del feed reemplaza al país objetivo en Content API for Shopping para obtener más detalles.

8 de diciembre de 2021

Servicio de cuentas

Recurso de la cuenta

Se agregó una nueva sección Account.AutomaticImprovements al recurso Accounts.

Esta nueva sección permitirá que los comercios actualicen automáticamente los artículos, mejoren las imágenes y la configuración de envío.

25 de octubre de 2021

Servicio de promoción

Se agregó Get Promotion a la API de Promotion.

11 de octubre de 2021

API de Shipping Settings

Se agregó un nuevo campo warehouse en el recurso ShippingSettings para permitir que los comercios administren los almacenes que se pueden usar en WarehouseBasedDeliveryTime.

Se agregó un nuevo campo warehouseName en WarehouseBasedDeliveryTime para hacer referencia al almacén por su nombre.

4 de octubre de 2021

Servicio de cuentas

Recurso de la cuenta

Se agregó un nuevo campo "phone_verification_status" en la sección Accounts.BusinessInformation. Este es un campo de solo lectura que establece Accounts.VerifyPhoneNumber.

13 de septiembre de 2021

Servicio de BuyOnGooglePrograms

Recurso BuyOnGoogleProgramStatus

Se agregaron campos nuevos en el recurso BuyOnGooglePrograms.BuyOnProgramStatus que representan los canales de ventas en línea, los modelos de negocio y el teléfono de atención al cliente.

Nuevo método UpdateBuyOnGoogleProgramStatus

Se agregó un nuevo método UpdateBuyOnGoogleProgramStatus que permitirá actualizar el recurso BuyOnGooglePrograms.BuyOnProgramStatus extendido.

6 de septiembre de 2021

Servicio de cuentas

Recurso de la cuenta

Se agregó un nuevo campo "korean_business_registration_number" en la sección Accounts.BusinessInformation. Este campo solo se borrará si se establece explícitamente como una cadena vacía.

30 de agosto de 2021

Servicio de promoción

Se agregó un nuevo servicio de promoción con la opción Insert Promotion disponible.

Servicio de pedidos

Se agregó un nuevo método orders/captureOrder para capturar fondos antes del envío.

Nuevo motivo de cancelación del pedido FAILED_TO_CAPTURE_FUNDS

Servicio de productos

Recurso del producto

Se agregaron productLength, productHeight, productWidth y productWeight para proporcionar las dimensiones y el peso del producto.

9 de agosto de 2021

Servicio de RepricingRule

Tipo de RepricingRule

Es el nuevo valor de enumeración para el campo RepricingRuleType.

Se agregaron TYPE_SALES_VOLUME_BASED y TYPE_COMPETITIVE_PRICE.

17 de mayo de 2021

Servicio de etiquetas de devoluciones de pedidos

Se agregó un nuevo campo "product_id" en CreateReturnRequest. Los comercios pueden especificar el product_id o el line_item_id para identificar el artículo que se devolverá.

Servicio de productos

Se agregó un nuevo método para actualizar productos existentes. Puedes actualizar un producto proporcionando solo los campos que se deben actualizar en lugar de todo el producto.

3 de mayo de 2021

Servicio de etiquetas de devoluciones de pedidos

Se agregaron métodos nuevos para subir etiquetas de devoluciones administradas por el comercio (MMR). Con el nuevo orderreturns.labels.create, puedes subir las etiquetas de devolución para compartirlas con el cliente.

26 de abril de 2021

API de Shipping Settings

Se agregó un nuevo campo warehouseBasedDeliveryTimes en DeliveryTime para admitir servicios de envío que calculan la fecha de entrega estimada según la ubicación del almacén y el servicio de la empresa de transporte elegido.

Se agregó un nuevo campo eddServices al objeto CarriersCarrier para devolver los nombres de los servicios aplicables para calcular la fecha de entrega estimada.

12 de abril de 2021

Servicio de productos

Recurso del producto

Se agregó un nuevo campo additionalSizeType para admitir hasta 2 tipos de tallas por producto.

Cambios en el campo de envío: Se agregaron minHandlingTime, maxHandlingTime, minTransitTime y maxTransitTime a ProductShipping para proporcionar la velocidad de envío a nivel de la oferta.

28 de enero de 2021

Servicio de cuentas

Se agregó compatibilidad con etiquetas automáticas a los recursos AccountLabel y Account. Para obtener más información, consulta la sección Tipos de etiquetas de CSS en la guía de administración de etiquetas de CSS.

5 de octubre de 2020

Servicio de CSSES

Recurso de CSS

Se agregó un nuevo servicio csses para recuperar información sobre los dominios de CSS y asignarles etiquetas. Ahora también se puede usar el recurso AccountLabel para crear y mostrar etiquetas a nivel del grupo de CSS. Para obtener más información, consulta Administración de etiquetas de CSS.

24 de agosto de 2020

Servicio de productos

Recurso Products

Se agregó el nuevo campo shoppingAdsExcludedCountries para excluir ofertas de la publicidad en determinados países.

Recurso Productstatuses

Nuevos campos approvedCountries, pendingCountries y disapprovedCountries en el objeto destinationStatuses que proporcionan información sobre el estado de la oferta más allá de targetCountry.

Nuevo campo itemLevelIssues.applicableCountries

10 de agosto de 2020

Servicio de cuentas

Se agregó un nuevo recurso AccountLabel para administrar las etiquetas de la cuenta de Merchant Center en CSS Center. Los usuarios de CSS Center ahora también pueden enumerar sus cuentas de Merchant Center y asignarles etiquetas con los métodos accounts.list, accounts.get y accounts.updatelabels. Para obtener más información, consulta Administración de etiquetas de CSS.

19 de junio de 2020

Servicio de productos

Recurso del producto

Campos nuevos

Nuevos campos productDetails, productHighlights, subscriptionCost y canonicalLink

2 de junio de 2020

Servicio de pedidos

Se agregaron métodos nuevos para iniciar reembolsos sin devoluciones. Con los nuevos objetos orders.refunditem y orders.refundorder, puedes iniciar reembolsos de pedidos incluso si el cliente no los devolvió.

27 de abril de 2020

Servicio de Orderreturns

Se agregaron los métodos nuevos acknowledge y process, y los filtros y campos nuevos para los métodos de lectura (list, get).

Vinculación de GMB

Se agregó la capacidad de vincular cuentas de Merchant Center a una cuenta de GMN con el ID de la cuenta de GMN.

14 de abril de 2020

APIs de informes de liquidación

Se agregó un nuevo servicio para obtener informes de liquidación.

9 de marzo de 2020

API de Local Inventory

Se agregó un nuevo servicio para enviar datos del inventario local.

2 de marzo de 2020

API de configuración de notificaciones de Pub/Sub

Se agregó un servicio nuevo para administrar la configuración de las notificaciones de Pub/Sub.

3 de diciembre de 2019

Servicio de productos

Se agregó compatibilidad con los feeds complementarios de Content API para cuentas de varios clientes.

11 de septiembre de 2019

Servicio de pedidos

Se agregó compatibilidad con los envíos para retiro en pedidos y las funciones correspondientes del entorno de pruebas.

14 de agosto de 2019

Servicios nuevos

Se agregaron los nuevos servicios Returnpolicy y Returnaddress para Comprar con Google.

Servicio de pedidos

Recurso de pedido

Nuevo campo

Nuevo campo quantityUndeliverable

7 de agosto de 2019

Servicio de pedidos

Recurso de pedido

Campos nuevos

Se agregaron los nuevos campos loyaltyInfo y invoiceReceivingEmail al recurso Order.

1 de julio de 2019

Servicio de productos

Se agregó compatibilidad con los feeds complementarios de Content API en el servicio de Products.

11 de junio de 2019

Servicio de pedidos

Recursos Order y TestOrder

Se agregó un ajuste de precio

Se agregó un nuevo campo lineItem[].adjustments que contiene el ajuste del precio y el impuesto originales del concepto causado por la aplicación de promociones.

14 de febrero de 2019

Cambios introducidos en esta versión

Ya no se admiten las ejecuciones de prueba

Se quitó el parámetro dryRun de la versión 2.1. Esto se aplica a todas las llamadas a la API.

Ya no se admiten los métodos de parche

Los siguientes servicios ya no admiten el método patch:

  • Cuentas
  • Accounttax
  • Feeds de datos
  • Liasettings
  • Shippingsettings

Se quitaron los métodos HTTP BATCH

Se quitaron todos los métodos HTTP BATCH de la versión 2.1. Usa customBatch en su lugar. Los servicios afectados son los siguientes:

  • Cuentas
  • Accountstatuses
  • Feeds de datos
  • Datafeedstatuses
  • Liasettings
  • Orderreports
  • Pos.
  • Productos
  • Productstatuses
  • Shippingsettings

Servicio de cuentas

Actualizar

Los campos businessInformation y googleMyBusinessLink de la solicitud se introdujeron después del lanzamiento inicial de la versión 2 de la API de Content. Por este motivo, existe una protección que evita que los comercios borren sin querer la información de estos dos campos con update si no se proporciona.

En la versión 2, los comercios deben proporcionar explícitamente estos campos con un cuerpo vacío ( {}) para borrarlos. En la versión 2.1, los campos se borran si proporcionas un cuerpo vacío o si no los proporcionas.

Recurso de la cuenta

Cambio de marca de AdWords a Google Ads

Con la conversión de AdWords en Google Ads, se cambiaron los nombres de los siguientes campos relacionados con AdWords:

  1. adwordsLinks -> adsLinks
  2. adwordsLinks.adwordsId -> adsLinks.adsId
Se quitaron los campos y valores obsoletos

Se quitó el campo obsoleto reviewsUrl. Además, se quitó el estado del vínculo inactive para adsLinks, googleMyBusinessLink y youtubeChannelLinks.

Servicio de Accountstatuses

Recurso AccountStatus

Se quitó dataQualityIssues

Estos se reemplazaron por itemLevelIssues.

Servicio de feeds de datos

Recurso de feed de datos

Se quitaron los campos obsoletos

Los campos contentLanguage, targetCountry y intendedDestinations se quitaron y se reemplazaron por country, language, includedDestinations y excludedDestinations en targets.

Eliminación de la actualización del inventario de productos

Se quitaron los feeds de tipo product inventory update.

Servicio de inventario

Se quitó el servicio inventory de la versión 2 y se reemplazó por dos funciones nuevas en la versión 2.1:

Servicio de pedidos

CancelLineItem

Se quitaron los campos amount, amountPretax y amountTax de la solicitud. El importe del reembolso ahora se calcula automáticamente.

CustomBatch

Se quitó CustomBatch de la versión 2.1.

InStoreRefundLineItem

Los campos amountPretax y amountTax se reemplazaron por priceAmount y taxAmount, respectivamente. El campo priceAmount puede incluir o no impuestos, según la ubicación del pedido.

Reembolso

Se quitó este método. Usa returnRefundLineItem en su lugar.

ReturnLineItem

Se quitó este método. En su lugar, usa returnRefundLineItem sin proporcionar un importe de reembolso.

ReturnRefundLineItem

Los campos amountPretax y amountTax se reemplazaron por priceAmount y taxAmount, respectivamente. El campo priceAmount puede incluir o no impuestos, según la ubicación del pedido.

ShipLineItem

Los campos carrier, shipmentId y trackingId de la solicitud se movieron a shipmentInfos.

Recursos Order y TestOrder

Nuevo formato de promoción

En la versión 2.1, hay un nuevo formato de promoción. No puedes crear pedidos de prueba con promociones.

Se quitaron los campos obsoletos

Se quitó el campo paymentMethod, y billingAddress y predefinedBillingAddress ahora son campos de nivel superior en Order y TestOrder, respectivamente.

Además, se quitó customer.explicitMarketingPreference y se reemplazó por customer.marketingRightsInfo en Order y TestOrder.

Se quitó el campo obsoleto customer.email.

El formato del campo promotions cambió en el recurso Order.

Servicio de Orderpayments

Este servicio se quitó de la versión 2.1.

Servicio de productos

La respuesta de un insert solo contendrá los siguientes atributos:

  • channel
  • contentLanguage
  • id
  • offerId
  • targetCountry

Las advertencias y los errores no fatales ya no se devuelven en la respuesta. Esto permite una mejor integración con las reglas de feeds y otras funciones avanzadas de administración de feeds.

Ahora hay una demora de unos minutos antes de que get o list puedan recuperar un producto insertado.

Ya no se garantiza que el ID de oferta devuelto sea el mismo que el ID de oferta de entrada.

Ahora los precios se validan antes de la inserción del producto. Solo se permiten los siguientes caracteres en la cadena de valor: +, -, . y dígitos (0 a 9). Ya no se aceptan comas.

Recurso del producto

Se reemplazaron CustomGroups por CustomAttributes recursivos

Anteriormente, los atributos personalizados se podían agrupar agregando atributos personalizados en el mismo grupo personalizado en la versión 2. Los atributos personalizados ahora son recursivos en la versión 2.1, por lo que ya no se necesitan grupos personalizados.

Los atributos personalizados ahora tienen un campo groupValues adicional además del campo value original. Se debe establecer exactamente uno de ellos, lo que significa que no se pueden establecer simultáneamente ni omitir.

Como los comercios pueden cambiar entre la versión 2 y la versión 2.1, es posible que los productos tengan atributos personalizados recursivos que no se pueden representar en la versión 2, ya que los grupos personalizados tienen un máximo de dos niveles. En este caso, el grupo de atributos personalizados se truncará.

Se quitaron el tipo y la unidad de customAttributes

En la versión 2.1, los atributos personalizados ya no contendrán type ni unit. En su lugar, las unidades se deben agregar a value (si está presente) y los tipos se deben detectar automáticamente. Por ejemplo, usa "1.23 EUR" o "5.6 cm" como value en la versión 2.1.

ProductTypes reemplaza a productType y additionalProductTypes

Anteriormente, los tipos de productos se almacenaban en dos campos: el primer tipo en el campo singular productType y los restantes en el campo repetido additionalProductTypes. En la versión 2.1, los dos campos se reemplazaron por un solo campo repetido productTypes.

Los atributos destinations se reemplazaron por includedDestinations y excludedDestinations

En la versión 2, los destinos se ingresaban como una lista de pares de intención y nombre de destino en el campo repetido destinations. Este campo se reemplazó por los siguientes dos campos repetidos: includedDestinations y excludedDestinations. No es necesario incluir los destinos habilitados de forma predeterminada en includedDestinations.. Esto coincidirá con la configuración de las anulaciones de destino en los feeds.

Con la conversión de AdWords en Google Ads, se cambiaron los nombres de los siguientes campos relacionados con AdWords:

  • adwordsGrouping -> adsGrouping
  • adwordsLabels -> adsLabels
  • adwordsRedirect -> adsRedirect
Se quitaron los campos obsoletos

Se quitaron los siguientes campos obsoletos:

  • aspects
  • destinations
  • onlineOnly
  • validatedDestinations
  • warnings

Servicio de Productstatuses

Get y List

Se quitaron el atributo product y el parámetro includeAttributes. Para recuperar los atributos del producto correspondientes a un estado, usa el servicio de Products y el valor del nuevo campo productId.

Lista

Se quitó el parámetro includeInvalidInsertedItems. Ahora se muestran todos los productos, independientemente de si son válidos, lo que significa que list ahora se comporta como si includeInvalidInsertedItems siempre estuviera establecido en true.

Recurso ProductStatus

DestinationsStatuses

Los campos intention, approvalStatus y approvalPending en destinationStatuses se reemplazaron por status, que es una cadena que puede ser approved, disapproved o pending.

Se quitó dataQualityIssues

Estos se reemplazaron por itemLevelIssues.