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

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

Si deseas usar la API de Merchant Center para leer la información de la configuración de envío, sigue estos pasos: solicitudes:

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

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

Si deseas usar la API de Merchant Center para leer la información de la configuración de envío, sigue estos pasos: 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, presentamos una comparación de ejemplo de Content API for Shopping con el comercio API de configuración de envío:

	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 Center deben accounts/{accountId}/shippingSettings hacia la {name} para que tenga el mismo comportamiento.
2. La API de Merchant Center no admite operaciones de lectura y escritura en áreas personalizadas, como como grupos por ubicación. Las áreas personalizadas, como los grupos por ubicación, solo se pueden leer o se escribe con el servicio de región.
3. La forma de configurar WarehouseBasedDeliveryTime es diferente para Merchant API en comparación con Content API for Shopping. Si usan 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 del almacén a través del 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 del comercio admite los siguientes campos nuevos en comparación con los siguientes: Content API for Shopping:

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

Campos con nombres cambiados

Se cambiaron los nombres de los siguientes campos en la API de Merchant Center:

Content API for Shopping	API de configuración de envío del comercio	Descripción
service	services	Un solo servicio de envío.
service.name	services.serviceName	Es el nombre del servicio en formato libre 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	Es la cantidad mínima de días hábiles 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	Es la cantidad máxima de días hábiles en tránsito de un pedido.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Indica la cantidad mínima de días hábiles invertidos antes de que se envíe un pedido.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Es la cantidad máxima de días hábiles invertidos antes de que se envíe un pedido.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Es el identificador de la zona horaria del horario 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	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	Una lista de tablas secundarias.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Es una lista de las tarifas de las empresas de transporte.
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 de Content API dejaron de estar disponibles en la API de Merchant Center. Comerciante La API 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

Esta es una comparación de los métodos de la Content API for Shopping API de configuración de envío del comercio:

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