30 de octubre de 2024
Servicios relacionados con los acuerdos
Como parte del cierre de las APIs relacionadas con el acuerdo, los siguientes servicios dejarán de estar disponibles:
- settlementreports
- settlementtranscations
La baja de las APIs relacionadas con los acuerdos está relacionada con el programa BuyOnGoogle que se había cerrado anteriormente y las APIs relacionadas con Orders.
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 actualizan todos los campos que tienen un valor no vacío.
26 de agosto de 2024 (antes de lo que se comunicó originalmente)
Servicios relacionados con pedidos
Como parte de la baja de las APIs relacionadas con pedidos, los siguientes servicios dejaron de estar disponibles:
- 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 dejó de estar disponible y sigue 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 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 se aplica el precio para miembros del programa de lealtad. Si no se proporciona el valor del campo, el precio para miembros siempre es 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 LoyaltyProgram singular.
Servicio de informes
Métricas de Comprar con Google obsoletas en la tabla MerchantPerformanceView Después de esta actualización, la recuperación de cualquier métrica de Comprar con Google muestra 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 calificación), 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 eficacia 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 tus precios actuales y los sugeridos.
24 de abril de 2024
Servicio de productos
Recurso del producto
Se agregaron los campos opcionales downpayment y creditType para los pagos en cuotas:
downpaymentproporciona el importe que el comprador debe pagar por adelantado como un pago único.creditTypeproporciona el tipo de pago en cuotas (financeolease). 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 gratuito. - 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 que los socios soliciten un nuevo tipo de acción: BuiltInUserInputAction. Esta acción permite a los socios crear 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 este formulario.
27 de marzo de 2024
Servicio de productos
Recurso del producto
Se agregó AutoPricingMinPrice como 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 preserva el valor y la rentabilidad de la oferta.
15 de marzo de 2024
Sunset 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 informes.
6 de marzo de 2024
Servicio de informes
Se agregaron el bucket de potencial de clics y la clasificación de los productos.
Para obtener más información, consulta nuestras guías de informes.
19 de febrero de 2024
Servicio de ConversionSources
Se quitaron los siguientes valores como fuentes de conversiones válidas:
CROSS_CHANNEL_FIRST_CLICKCROSS_CHANNEL_LINEARCROSS_CHANNEL_POSITION_BASEDCROSS_CHANNEL_TIME_DECAY
Se quitaron las opciones de 60 y 90 días como ventana 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 coincidencia de tiendas.
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 permiten que las cuentas se vinculen con el fin 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 que los usuarios conozcan el estado de coincidencia de la tienda del PdV con la tienda del Perfil de Negocio de Google y que reciban sugerencias para corregirlo en caso de que haya un problema.
15 de noviembre de 2023
Los extremos repricingrules y repricingrules.repricingreports ya no son compatibles.
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 autoidentificarse 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., que no es propiedad del comercio) para entregar el artículo en una ubicación afiliada de terceros (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 de varios canales (es decir, la configuración de la tienda local y la de retiro). Por el momento, esta función solo está disponible para los usuarios cuyo proveedor de PdV es de confianza para habilitar esa configuración.
7 de septiembre de 2023
Baja de Comprar con Google
Se agrega un nuevo estado DEPRECATED al método GetBuyOnGoogleProgramStastus.
No es posible reactivar o 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 de productos que se deben resolver a nivel de la cuenta. Se agregó una 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
Abre el método list en el servicio Promotions de acceso limitado a 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 de cuentas y productos.
4 de agosto de 2023
Servicio de informes
Se agregó el informe Visibilidad de competencia respecto de la competencia al servicio Informes.
Si deseas obtener más información, consulta nuestras Guías de informes.
25 de julio de 2023
Servicio de PdV
Recurso de inventario
Agrega los campos pickup_method y pickup_sla para permitir que los comercios envíen información de retiro junto con su inventario.
14 de julio de 2023
Servicio de informes
Se agregaron los informes de Visibilidad de competencia al servicio de informes.
Para obtener más información, consulta nuestras guías de informes.
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
Agrega 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 del 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 n + 1 días cuando tengan un servicio de envío configurado para ese tipo de entrega.
29 de mayo de 2023
Servicio de promociones
Se agregó el método list para el servicio Promotions.
Servicio de recomendaciones
Habilita la anulación de interacción en el método ReportInteraction del servicio Recommendations.
9 de mayo de 2023
Destino de Cloud Retail
Propiedades adicionales de Cloud Retail
Agrega el campo de propiedades adicionales de la venta minorista en la nube. Este es un campo repetido que los clientes que usan el destino de Cloud Retail deben usar. Cuando se use este campo, estará disponible cuando se use el programa de venta minorista en la nube. Esto 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 para entrega local para los comercios que crean una configuración de envío nueva. Pueden configurar la configuración de las tiendas locales en el nuevo campo storeConfig. Esto incluye el radio de servicio, el horario límite y los códigos de tienda para 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 del comerciante en 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 admite la administración de fuentes de conversiones (parte de la sección Configuración de conversiones en Merchant Center).
16 de feb de 2023
Servicio de configuración de envío
Validación del código de tienda
Los códigos de tienda ahora se validan para garantizar que pertenezcan al comercio antes de actualizar la configuración de envío.
Validación del comercio en un LIA
Los programas en los que está inscrito un ID de comerciante ahora se validan antes de que se actualice la configuración de envío. Los comercios deben estar inscritos en uno de los siguientes programas:
LOCAL_INVENTORY_ON_SURFACES_ACROSS_GOOGLELOCAL_INVENTORY_ADS
9 de febrero de 2023
Servicio de promociones
Expande el servicio de promociones a 6 opciones adicionales de targetCountry con asistencia local de contentLanguage:
BRESNLJPITKR
12 de ene de 2023
Servicio de productos
Recurso del producto
Se agregó lifestyleImageLinks para proporcionar URLs a las 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 es un campo de solo lectura.
15 de nov de 2022
Servicio de informes
Se agregaron informes de Market Insights al servicio de informes.
Ahora puedes consultar el servicio de informes para lo siguiente:
- Informes de los más vendidos con las tablas
BestSellersProductClusterViewyBestSellersBrandView - Informe de competitividad de los 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 informes.
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. Los IDs de oferta ahora se construyen como online:language:feedLabel:offerId.
feedLabel se propagó automáticamente con tu valor de targetCountry para los feeds existentes para la retrocompatibilidad.
targetCountry quedó obsoleto.
Para admitir ofertas globales, Content API for Shopping dejó de admitir el campo targetCountry. En su lugar, te recomendamos que uses el campo shipping para especificar tus países de segmentación.
targetCountry ahora se propaga automáticamente con el valor que proporcionas en feedLabel.
Consulta la entrada de blog La etiqueta del feed reemplaza el país de segmentación 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 en el recurso Accounts.
Esta sección nueva 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.
Agrega un nuevo campo warehouseName en WarehouseBasedDeliveryTime para hacer referencia al almacén por 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 siguientes datos: canales de ventas en línea, modelos de negocio y teléfono de atención al cliente.
Nuevo método UpdateBuyOnGoogleProgramStatus
Se agregó un nuevo método UpdateBuyOnGoogleProgramStatus que permitirá actualizar el recurso extendido BuyOnGooglePrograms.BuyOnProgramStatus.
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 promoción Insertar 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 RepricingRule
Tipo de RepricingRule
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. Para actualizar un producto, solo debes proporcionar 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 nuevos métodos 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
Nuevo campo warehouseBasedDeliveryTimes en DeliveryTime para admitir servicios de envío que calculan la fecha de entrega estimada en función de la ubicación del almacén y el servicio de la empresa de transporte elegido.
Nuevo campo eddServices en el objeto CarriersCarrier para mostrar los nombres de los servicios aplicables para calcular la fecha de entrega estimada.
12 de abril de 2021
Servicio de productos
Recurso del producto
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 CSS
Se agregó un nuevo servicio csses para recuperar información sobre los dominios de CSS y asignarles etiquetas. El recurso AccountLabel ahora también se puede usar para crear y enumerar etiquetas de nivel de 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 de productos
Nuevo campo shoppingAdsExcludedCountries para excluir ofertas de la publicidad en ciertos 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 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 orders.refunditem y orders.refundorder, puedes iniciar reembolsos de pedidos incluso si el cliente no los devuelve.
27 de abril de 2020
Servicio de devoluciones de pedidos
Se agregaron nuevos métodos acknowledge y process, y nuevos filtros y campos para 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 nuevo servicio para administrar la configuración de las notificaciones de PubSub.
3 de diciembre de 2019
Servicio de productos
Se agregó compatibilidad con los feeds complementarios de Content API de cuentas de varios clientes.
11 de septiembre de 2019
Servicio de pedidos
Se agregó compatibilidad con los envíos para retiro en los pedidos y las funciones de zona de pruebas correspondientes.
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 campos loyaltyInfo y invoiceReceivingEmail nuevos al recurso de pedido.
1 de julio de 2019
Servicio de productos
Compatibilidad con feeds complementarios de Content API agregados en el servicio de productos
11 de junio de 2019
Servicio de pedidos
Recursos Order y TestOrder
Se agregó el ajuste de precios
Se agregó un nuevo campo lineItem[].adjustments que contiene el ajuste del precio y el impuesto de la línea de pedido originales debido a 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
- Impuesto de la cuenta
- Feeds de datos
- Configuración de contactos
- Shippingsettings
Eliminación de los métodos HTTP BATCH
Se quitaron todos los métodos BATCH de HTTP de la versión 2.1. Usa customBatch en su lugar.
Los servicios afectados son los siguientes:
- Cuentas
- Estados de la cuenta
- Feeds de datos
- Datafeedstatuses
- Configuración de contactos
- Orderreports
- Posición
- Productos
- Productstatuses
- Shippingsettings
Servicio de cuentas
Actualizar
Los campos businessInformation y googleMyBusinessLink en la solicitud se introdujeron después del lanzamiento inicial de la versión 2 de Content API. Debido a esto, existe una protección que evita que los comercios borren información de estos dos campos con update por error si no se proporcionan.
En la versión 2, los comercios deben proporcionar estos campos de forma explícita 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 el cambio de AdWords a Google Ads, se cambió el nombre de los siguientes campos relacionados con AdWords:
adwordsLinks->adsLinksadwordsLinks.adwordsId->adsLinks.adsId
Eliminación de campos y valores obsoletos
Se quitó el campo obsoleto reviewsUrl. Además, se quitó el estado de vinculación inactive para adsLinks, googleMyBusinessLink y youtubeChannelLinks.
Servicio de Accountstatuses
Recurso AccountStatus
Eliminación de dataQualityIssues
Estos fueron reemplazados por itemLevelIssues.
Servicio de feeds de datos
Recurso de feed de datos
Eliminación de 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 del 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 actualizaciones de productos parciales.
- Usa el nuevo servicio
localinventorypara las actualizaciones de productos locales.
Servicio de pedidos
CancelLineItem
Se quitaron los campos amount, amountPretax y amountTax de la solicitud. El importe reembolsado 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 ser sin impuestos o con 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 ser sin impuestos o con 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
Hay un nuevo formato de promoción en la versión 2.1. No puedes crear pedidos de prueba con promociones.
Eliminación de 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 pagos de pedidos
Se quitó este servicio de la versión 2.1.
Servicio de productos
La respuesta de un insert contendrá solo los siguientes atributos:
channelcontentLanguageidofferIdtargetCountry
Las advertencias y los errores no fatales ya no se muestran en la respuesta. Esto permite una mejor integración con las reglas de feed y otras funciones avanzadas de administración de feed.
Ahora hay un retraso de unos minutos antes de que get o list puedan recuperar un producto insertado.
Ya no se garantiza que el ID de oferta que se muestra sea el mismo que el ID de oferta de entrada.
Ahora, los precios se validan antes de insertar los productos. Solo se permiten los siguientes caracteres en la cadena de valor: +, -, . y dígitos (0-9). Ya no se aceptan comas.
Recurso del producto
CustomGroups reemplazado por customAttributes recurrentes
Anteriormente, se podían agrupar atributos personalizados agregando atributos personalizados en el mismo grupo personalizado en la versión 2. Los atributos personalizados ahora son recurrentes en la versión 2.1, por lo que ya no es necesario crear grupos personalizados.
Los atributos personalizados ahora tienen un campo groupValues adicional además del campo value original. Se debe configurar exactamente uno de ellos, lo que significa que no se pueden configurar ni omitir en simultáneo.
Dado que los comercios pueden cambiar entre la v2 y la v2.1, es posible que los productos tengan atributos personalizados recursivos que no se pueden representar en la v2, ya que los grupos personalizados tienen un máximo de dos niveles. En este caso, se truncará el grupo de atributos personalizados.
Eliminación de type y unit en 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 las hay), y los tipos se deben detectar automáticamente. Por ejemplo, usa "1.23 EUR" o "5.6 cm" como value en la v2.1.
ProductTypes reemplaza a productType y additionalProductTypes
Antes, los tipos de productos se almacenaban en dos campos: el primero, en el campo singular productType, y el resto, en el campo repetido additionalProductTypes. En la versión 2.1, los dos campos se reemplazaron por un solo campo repetido productTypes.
El atributo destinations se reemplazó por includedDestinations y excludedDestinations.
Los destinos se ingresaban como una lista de pares de nombres de destino y de intenciones en la versión 2 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 el cambio de AdWords a Google Ads, se cambió el nombre de los siguientes campos relacionados con AdWords:
adwordsGrouping->adsGroupingadwordsLabels->adsLabelsadwordsRedirect->adsRedirect
Eliminación de campos obsoletos
Se quitaron los siguientes campos obsoletos:
aspectsdestinationsonlineOnlyvalidatedDestinationswarnings
Servicio de Productstatuses
Obtener y enumerar
Se quitó el atributo product, junto con el parámetro includeAttributes. Para recuperar los atributos del producto correspondientes a un estado, usa
el servicio 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.
Eliminación de dataQualityIssues
Estos fueron reemplazados por itemLevelIssues.