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

El recurso ShippingSettings te permite recuperar y actualizar la configuración de envío de tu cuenta y de todas las cuentas secundarias asociadas a ella. Para obtener más información sobre cómo agregar o administrar la configuración de envío de tu cuenta, consulta Descripción general de la configuración de envío.

Para usar la API de Merchant y leer la información de la configuración de envío, usa 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.

Para usar la API de Merchant y actualizar la información de la configuración de envío, usa las siguientes solicitudes:

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

Para obtener más información, consulta Método: accounts.shippingSettings.insert.

Comparación entre Content API for Shopping y Merchant API

A continuación, se muestra una comparación de muestra de Content API for Shopping con la API de Merchant Shipping Settings:

	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 tener el mismo comportamiento.
2. La API de Merchant no admite operaciones de lectura y escritura en áreas personalizadas, como los grupos de ubicaciones. Las áreas personalizadas, como los grupos por ubicación, solo se pueden leer o escribir con el servicio de región.
3. La forma de configurar WarehouseBasedDeliveryTime es diferente para la API de Merchant en comparación con Content API for Shopping. Si usas la API de Merchant, debes definir la información del almacén en shippingsettings.warehouses. Luego, cada servicio de envío puede hacer referencia al almacén a través del nombre del almacén en warehouseBaseDeliveryTime.
4. Un servicio en la API de Merchant admite varios países de entrega.

Nuevos campos compatibles

La API de Merchant Shipping settings admite los siguientes campos nuevos en comparación con Content API for Shopping:

1. Almacén: Proporciona información sobre un almacén de distribución, que almacena y controla 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: El Etag está diseñado 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 con el nombre cambiado

Se cambió el nombre de los siguientes campos en la API de Merchant Center:

Content API for Shopping	API de Merchant Shipping settings	Descripción
service	services	Un solo servicio de envío
service.name	services.serviceName	Es un nombre de formato libre para el servicio que debe ser único en tu cuenta de Merchant Center.
service.deliveryCountry	services.deliveryCountries	Es el código de territorio de 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	Es la cantidad mínima de días hábiles que un pedido pasa en tránsito. Por ejemplo, 0 significa entrega el mismo día y 1 significa entrega al día siguiente.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Es la cantidad máxima de días hábiles que un pedido pasa en tránsito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Es la cantidad mínima de días hábiles que transcurren antes de que se envíe un pedido.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Es la cantidad máxima de días hábiles que transcurren antes de que se envíe un pedido.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Es el identificador de zona horaria para la hora límite.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	Es el nombre del grupo de códigos postales.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	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 del operador.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del 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 de Content API dejaron de estar disponibles en Merchant API. La API de Merchant no proporciona ninguna alternativa para estos campos.

• postal_code_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

A continuación, se muestra una comparación de los métodos de Content API for 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