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/v1/accounts/{ACCOUNT_ID}/shippingSettings

Reemplaza {ACCOUNT_ID} 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/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert

Para obtener más información, consulta Method:accounts.shippingSettings.insert.

Comparación entre Content API for Shopping y Merchant API

A continuación, se muestra un ejemplo de comparación entre Content API for Shopping y el recurso de configuración de envío en la sub-API de Accounts:

Content API API de Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/shippingSettings:insert
Identificadores {MERCHANT_ID}/shippingsettings/{ACCOUNT_ID} {NAME}

En la siguiente lista, se mencionan las principales actualizaciones del recurso de configuración de envío en la sub-API de Accounts en comparación con Content API for Shopping:

  1. Los usuarios de la API de Merchant deben colocar accounts/{ACCOUNT_ID}/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 regiones.
  3. Un servicio de la API de Merchant admite varios países de entrega.
  4. A diferencia del método shippingsettings.list de Content API, Merchant API no proporciona un método de lista para la configuración de envío.

Nuevos campos compatibles

El recurso de configuración de envío en la sub-API de Accounts admite los siguientes campos nuevos en comparación con Content API for Shopping:

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

Campos con el nombre cambiado

Se cambiaron los nombres de los siguientes campos en el recurso de configuración de envío de la sub-API de Accounts:

Content API for Shopping Recurso de configuración de envío Descripción
service services Un solo servicio de envío
service.name services.serviceName Nombre de formato libre del 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 Es la etiqueta de tiempo en tránsito del producto.
service.rate_group services.rateGroups Son las definiciones de los 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 Es una lista de tarifas de operadores.
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 quitados

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

Campos quitados

Los siguientes campos de Content API for Shopping se quitaron de 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

    • Rate_group
      • single_value_alternative_list

Métodos

A continuación, se muestra una comparación de los métodos en Content API for Shopping y el recurso de configuración de envío:

Método Content API for Shopping API de Merchant
customBatch Sí No
get Sí Sí
update Sí No
insert No Sí
list Sí No
getSupportedCarrier Sí No
getSupportedHolidays Sí No
Anterior
Migrate data sources management
Siguiente
Migrate conversion sources management