Cómo migrar la configuración de envío desde Content API for Shopping

Si quieres usar la API de Merchant para leer la información de la configuración de envío, realiza las siguientes solicitudes:

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings

Reemplaza {accountId} por el identificador único de tu cuenta de Merchant Center.

Si quieres usar la API de Merchant para leer la información de la configuración de envío, realiza las siguientes solicitudes:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert

Comparación entre la API de Content API for Shopping y la de Merchant Center

A continuación, verás un ejemplo de una comparación entre la API de Content para Shopping y la API de Merchant Shipping:

	Content API	API de Merchant Center
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Identificadores	{accountId}/shippingsettings/{accountId}	{name}

En la siguiente lista, se mencionan las actualizaciones más importantes de la API de Merchant Shipping Settings en comparación con Content API for Shopping:

1. Los usuarios de la API de Merchant deben colocar accounts/{accountId}/shippingSettings en el campo {name} para que tenga el mismo comportamiento.
2. La API de Merchant no admite operaciones de lectura y escritura en áreas personalizadas, como los grupos por ubicación. Las áreas personalizadas, como los grupos por ubicación, solo se pueden leer o escribir con el servicio regional.
3. La forma de configurar WarehouseBasedDeliveryTime es diferente en la API de Merchant Center y en la API de Content para Shopping. Si usas la API de Merchant Center, debes definir la información del almacén en shippingsettings.warehouses. Luego, cada servicio de envío puede hacer referencia al almacén mediante el nombre del almacén en warehouseBaseDeliveryTime.
4. Un servicio de la API de Merchant Center admite varios países de entrega.

Nuevos campos compatibles

La API de configuración de envío de Merchant Center admite los siguientes campos nuevos en comparación con Content API for Shopping:

1. Almacén de datos: Proporciona información sobre un almacén de entrega, que almacena y administra el inventario.
2. Programas de lealtad: Los usuarios de la API de Merchant pueden ingresar información del programa de lealtad en su configuración de envío.
3. Etag: Se diseñó para resolver problemas asíncronos cuando diferentes usuarios intentan actualizar la configuración de envío con la API de Merchant Center y la IU de Merchant Center al mismo tiempo.

Campos a los que se les cambió el nombre

En la API de Merchant Center, se cambió el nombre de los siguientes campos:

Content API for Shopping	API de Merchant Shipping Settings	Descripción
service	services	Un único servicio de envío.
service.name	services.serviceName	Es el nombre en formato libre del servicio que debe ser único en tu cuenta de Merchant Center.
service.deliveryCountry	services.deliveryCountries	Es el código de territorio CLDR del país al que se aplica el servicio de envío.
service.currency	services.currencyCode	Es el código CLDR de la moneda a la que se aplica este servicio.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Cantidad mínima de días hábiles que transcurren en tránsito de un pedido. Por ejemplo, 0 significa entrega el mismo día y 1 significa entrega al día siguiente.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Cantidad máxima de días hábiles que un pedido pasa en tránsito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Cantidad mínima de días hábiles que se dedican antes del envío de un pedido.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Cantidad máxima de días hábiles transcurridos antes de que se envíe un pedido.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Es el identificador de la zona horaria para la hora límite.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	El nombre del grupo de códigos postales.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	Es la etiqueta de tiempo en tránsito del producto.
service.rate_group	services.rateGroups	Definiciones de grupos de tarifas de envío.
service.rate_group.subtable	services.rateGroups.subtables	Es una lista de tablas secundarias.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Una lista de tarifas de la empresa de transportes.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de pedido.

Métodos obsoletos

No puedes usar shippingsettings.custombatch para recuperar y actualizar la configuración de envío de varias cuentas en una sola solicitud.

Campos obsoletos

Los siguientes campos dejaron de estar disponibles en la API de Merchant Center. Ten en cuenta que la API de Merchant no proporciona ninguna alternativa para estos campos.

Content API for Shopping	API de Merchant Center
postal_code_group	region
service Pickup_service Eligibility Scheduling_channel Delivery_time Holiday_cutoff Min_scheduling_time_in_days Max_scheduling_time_in_days Scheduling_business_day_config Rate_group |service: Pickup_service - Eligibility - Scheduling_channel - Delivery_time - Holiday_cutoff - Min_scheduling_time_in_days - Max_scheduling_time_in_days - Scheduling_business_day_config - Rate_group - single_value_alternative_list Métodos Esta es una comparación de los métodos de la API de Content para Shopping y la API de Merchant Shipping Settings: Método Content API for Shopping API de Merchant Center customBatch Sí No get Sí Sí update Sí No insert No Sí getSupportedCarrier Sí No getSupportedHolidays Sí No