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

El ShippingSettings recurso te permite recuperar y actualizar la configuración de envío de tu cuenta y de todas las subcuentas asociadas. 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 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 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 por ubicación. Las áreas personalizadas, como los grupos por ubicación, solo se pueden leer o escribir con el servicio de región.
  3. Un servicio en 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 en Content API.

Campos nuevos admitidos

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, que almacena y administra el inventario.
  2. Programas de lealtad: Los usuarios de la API de Merchant pueden ingresar información sobre el programa de lealtad en su configuración de envío.
  3. Etag: 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 y la IU de Merchant Center al mismo tiempo.

Campos con nombres modificados

Se cambió el nombre de los siguientes campos en el recurso de configuración de envío en 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 la zona horaria para el 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 subtables.
service.rate_group.carrier_rate services.rateGroups.carrierRates Una lista de tarifas de operadores.
service.minimumOrderValueTable.storeCodeSetWithMovs services.minimumOrderValueTable.storeCodeSetWithMovs 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

Se quitaron los siguientes campos de Content API for Shopping en 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 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