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:
- Los usuarios de la API de Merchant Center deben
accounts/{accountId}/shippingSettings
hacia la {name} para que tenga el mismo comportamiento. - 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.
- 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 enshippingsettings.warehouses
Luego, cada servicio de envío puede hacer referencia al del almacén a través del nombre del almacén enwarehouseBaseDeliveryTime
. - 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:
- Almacén: Proporciona información sobre un almacén de entrega. que almacena y maneja el inventario.
- 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.
- 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 |