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
Servicios relacionados con pedidos
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
Servicios relacionados con la liquidación
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)
Servicios relacionados con pedidos
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
olease
). 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:
- Informes de más vendidos con las tablas
BestSellersProductClusterView
yBestSellersBrandView
- Informe de competitividad de precios con la tabla
PriceCompetitivenessProductView
- Informe de estadísticas de precios con la tabla
PriceInsightsProductView
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:
adwordsLinks
->adsLinks
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:
- Usa los nuevos feeds complementarios para las actualizaciones parciales de productos.
- Usa el nuevo servicio
localinventory
para las actualizaciones de productos locales.
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.
Cambio de nombre de los campos relacionados con AdWords
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
.