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 puedes 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 Método: accounts.shippingSettings.insert.

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

A continuación, se muestra una comparación de ejemplo de Content API for Shopping con el recurso de configuración de envío en la sub-API de cuentas:

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 actualizaciones importantes en el recurso de configuración de envío en la sub-API de cuentas 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 por ubicación. 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. La API de Merchant no proporciona un método de lista para la configuración de envío, a diferencia del método shippingsettings.list de la API de Content.

Nuevos campos admitidos

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

  1. warehouses: 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 de los programas de lealtad en su configuración de envío.
  3. Etag: La etiqueta Etag está diseñada 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 nombres cambiados

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

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 Es el 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 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 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 la empresa de transporte.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de 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 la API de Merchant. 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 de 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 region management
Siguiente
Migrate online return policy management