Si quieres usar la API de Merchant para leer la información de la configuración de envío, realiza las siguientes solicitudes:
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings
Reemplaza {accountId} por el identificador único de tu cuenta de Merchant Center.
Si quieres usar la API de Merchant para leer la información de la configuración de envío, realiza las siguientes solicitudes:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Comparación entre la API de Content API for Shopping y la de Merchant Center
A continuación, verás un ejemplo de una comparación entre la API de Content para Shopping y la API de Merchant Shipping:
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 deben colocar
accounts/{accountId}/shippingSettings
en el campo {name} para que tenga el mismo comportamiento. - 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 regional.
- La forma de configurar
WarehouseBasedDeliveryTime
es diferente en la API de Merchant Center y en la API de Content para Shopping. Si usas 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 almacén mediante el 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 de Merchant Center admite los siguientes campos nuevos en comparación con Content API for Shopping:
- Almacén de datos: Proporciona información sobre un almacén de entrega, que almacena y administra el inventario.
- Programas de lealtad: Los usuarios de la API de Merchant pueden ingresar información del programa de lealtad en su configuración de envío.
- Etag: Se diseñó para resolver problemas asíncronos cuando diferentes usuarios intentan actualizar la configuración de envío con la API de Merchant Center y la IU de Merchant Center al mismo tiempo.
Campos a los que se les cambió el nombre
En la API de Merchant Center, se cambió el nombre de los siguientes campos:
Content API for Shopping | API de Merchant Shipping Settings | Descripción |
---|---|---|
service |
services |
Un único servicio de envío. |
service.name |
services.serviceName |
Es el nombre en formato libre del servicio 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 |
Cantidad mínima de días hábiles que transcurren 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 |
Cantidad máxima de días hábiles que un pedido pasa en tránsito. |
service.deliveryTime.minHandlingTimeInDays |
services.deliveryTime.minHandlingDays |
Cantidad mínima de días hábiles que se dedican antes del envío de un pedido. |
service.deliveryTime.maxHandlingTimeInDays |
services.deliveryTime.maxHandlingDays |
Cantidad máxima de días hábiles transcurridos antes de que se envíe un pedido. |
service.deliveryTime.cutoffTime.timezone |
services.deliveryTime.cutoffTime.timeZone |
Es el identificador de la zona horaria para la hora límite. |
service.deliveryTime.transitTimeTable.postalCodeGroupName |
services.deliveryTime.transitTimeTable.postalCodeGroupNames |
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 |
Es una lista de tablas secundarias. |
service.rate_group.carrier_rate |
services.rateGroups.carrierRates |
Una lista de tarifas de la empresa de transportes. |
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 dejaron de estar disponibles en la API de Merchant Center. Ten en cuenta que la API de Merchant no proporciona ninguna alternativa para estos campos.
Content API for Shopping | API de Merchant Center | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
postal_code_group |
region |
||||||||||||||||||||
service
| MétodosEsta es una comparación de los métodos de la API de Content para Shopping y la API de Merchant Shipping Settings:
|