- Representación JSON
- Servicio
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Día hábil
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Tabla
- Encabezados
- Peso
- WeightUnit
- LocationIdSet
- Fila
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distancia
- Unidad
- LoyaltyProgram
- LoyaltyProgramTiers
- Depósito
- Dirección
- WarehouseCutoffTime
La configuración de envío de la cuenta de comerciante
Representación JSON |
---|
{ "name": string, "services": [ { object ( |
Campos | |
---|---|
name |
Identificador. El nombre del recurso de la configuración de envío. Formato: |
services[] |
Opcional. La lista de servicios de la cuenta de destino. |
warehouses[] |
Opcional. Una lista de almacenes a los que se puede hacer referencia en |
etag |
Obligatorio. Este campo se usa para evitar problemas asíncronos. Asegúrate de que los datos de la configuración de envío no hayan cambiado entre las llamadas get y insert. El usuario debe seguir estos pasos:
|
Servicio
Servicio de envío.
Representación JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campos | |
---|---|
deliveryCountries[] |
Obligatorio. Es el código de territorio CLDR de los países a los que se aplica el servicio. |
rateGroups[] |
Opcional. Definiciones de grupos de tarifas de envío Solo el último puede tener un |
loyaltyPrograms[] |
Opcional. Programas de lealtad a los que se limita este servicio de envío |
serviceName |
Obligatorio. Es el nombre del servicio de formato libre. Debe ser único en la cuenta de destino. |
active |
Obligatorio. Es un valor booleano que expone el estado activo del servicio de envío. |
currencyCode |
Es el código CLDR de la moneda a la que se aplica este servicio. Debe coincidir con los precios de los grupos de tarifas. |
deliveryTime |
Obligatorio. Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto. |
shipmentType |
Es el tipo de ubicaciones a las que este servicio envía pedidos. |
minimumOrderValue |
Es el valor mínimo del pedido para este servicio. Si se establece, indica que los clientes deberán invertir, al menos, este importe. Todos los precios de un servicio deben tener la misma moneda. No se puede establecer junto conminimumOrderValueTable. |
minimumOrderValueTable |
Tabla de valores mínimos de pedidos por tienda para el tipo de entrega de retiro en tienda. No se puede establecer junto con minimumOrderValue. |
storeConfig |
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local. |
DeliveryTime
Es el tiempo dedicado a varios aspectos, desde el pedido hasta la entrega del producto.
Representación JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campos | |
---|---|
warehouseBasedDeliveryTimes[] |
Opcional. Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se configura, no se debe establecer ningún otro campo relacionado con el tiempo en tránsito en [tiempo de entrega][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]. |
minTransitDays |
Es la cantidad mínima de días hábiles que transcurren en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Se debe establecer |
maxTransitDays |
Es la cantidad máxima de días hábiles que se pasan en tránsito. 0 significa entrega el mismo día, 1 significa entrega al día siguiente. Debe ser mayor o igual que |
cutoffTime |
Definición de la hora límite de los días hábiles. Si no se configura, se establecerá de forma predeterminada el horario límite a las 8 a.m. PST. |
minHandlingDays |
Es la cantidad mínima de días hábiles que transcurren antes de que se envíe un pedido. 0 significa envío el mismo día, 1 significa envío al día siguiente. "minHandlingDays" y "maxHandlingDays" deben establecerse o no al mismo tiempo. |
maxHandlingDays |
Es la cantidad máxima de días hábiles invertidos antes de que se envíe un pedido. 0 significa que se envió el mismo día y 1 significa que se envió al día siguiente. Debe ser mayor o igual que |
transitTimeTable |
Tabla de tiempo en tránsito, que corresponde a la cantidad de días hábiles que se pasaron en tránsito según las dimensiones de filas y columnas. Se puede configurar |
handlingBusinessDayConfig |
Son los días hábiles durante los cuales se pueden procesar los pedidos. Si no se proporciona, se asumirán los días hábiles de lunes a viernes. |
transitBusinessDayConfig |
Los días hábiles durante los cuales los pedidos pueden estar en tránsito. Si no se proporciona, se supondrán los días hábiles de lunes a viernes. |
CutoffTime
Definición del horario límite de los días hábiles.
Representación JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
minute |
Obligatorio. Es el minuto de la hora límite hasta la que se debe realizar un pedido para que se procese el mismo día. |
timeZone |
Obligatorio. Identificador de la zona horaria Por ejemplo, "Europa/Zúrich". |
TransitTable
Tabla del tiempo en tránsito, cantidad de días hábiles en tránsito según las dimensiones de fila y columna Se puede configurar minTransitDays
, maxTransitDays
o transitTimeTable
, pero no ambos.
Representación JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
Campos | |
---|---|
postalCodeGroupNames[] |
Obligatorio. Es una lista de nombres de regiones |
transitTimeLabels[] |
Obligatorio. Es una lista de etiquetas de tiempo en tránsito. El último valor puede ser |
rows[] |
Obligatorio. Si solo hay un conjunto de dimensiones de |
TransitTimeRow
Si solo hay un conjunto de dimensiones de postalCodeGroupNames
o transitTimeLabels
, hay varias filas, cada una con un valor para esa dimensión. Si hay dos dimensiones, cada fila corresponde a un postalCodeGroupNames
y las columnas (valores) a un transitTimeLabels
.
Representación JSON |
---|
{
"values": [
{
object ( |
Campos | |
---|---|
values[] |
Obligatorio. Es el intervalo de tiempo en tránsito (mínimo y máximo) en días hábiles. |
TransitTimeValue
Es el intervalo de tiempo en tránsito (mínimo y máximo) en días hábiles.
Representación JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Campos | |
---|---|
minTransitDays |
Intervalo de tiempo mínimo en tránsito en días hábiles. 0 significa entrega el mismo día y 1 significa entrega al día siguiente. |
maxTransitDays |
Debe ser mayor o igual que |
BusinessDayConfig
Días hábiles del depósito
Representación JSON |
---|
{
"businessDays": [
enum ( |
Campos | |
---|---|
businessDays[] |
Obligatorio. Días hábiles normales. No puede estar vacío. |
Día de semana
Enumeraciones | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
Indica que el tiempo de entrega se debe calcular por almacén (ubicación de origen del envío) según la configuración de la empresa de transporte seleccionada. Cuando se establece, no se debe establecer ningún otro campo relacionado con el tiempo de tránsito en deliveryTime
.
Representación JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
Campos | |
---|---|
carrier |
Obligatorio. Proveedor, como |
carrierService |
Obligatorio. Servicio de operador, como |
warehouse |
Obligatorio. Es el nombre del almacén. Debería coincidir con [warehouse][ShippingSetting.warehouses.name]. |
RateGroup
Definiciones de grupos de tarifas de envío Solo el último puede tener un applicableShippingLabels
vacío, que significa "todo lo demás". El otro applicableShippingLabels
no debe superponerse.
Representación JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campos | |
---|---|
applicableShippingLabels[] |
Obligatorio. Es una lista de etiquetas de envío que definen los productos a los que se aplica este grupo de tarifas. Esta es una disyunción: solo una de las etiquetas debe coincidir para que se aplique el grupo de tarifas. Solo puede estar vacío para el último grupo de tarifas de un servicio. |
subtables[] |
Opcional. Una lista de tablas secundarias a las que hace referencia |
carrierRates[] |
Opcional. Es una lista de las tarifas de la empresa de transporte a las que se puede hacer referencia mediante |
singleValue |
Es el valor del grupo de tarifas (por ejemplo, una tarifa plana de USD 10). Solo se puede establecer si no se configuran |
mainTable |
Una tabla que define el grupo de tarifas, cuando |
name |
Opcional. Nombre del grupo de tarifas. Si se configura debe ser único dentro del servicio de envío. |
Valor
El valor único de un grupo de tarifas o el valor de la celda de la tabla de un grupo de tarifas. Se debe configurar exactamente uno de los siguientes valores: noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
.
Representación JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
Campos | |
---|---|
noShipping |
Si es "true", el producto no se puede enviar. Debe ser verdadera cuando se establece; solo se puede establecer si no se establecen todos los demás campos. |
flatRate |
Una tarifa plana. Solo se puede establecer si no están configurados todos los demás campos. |
pricePercentage |
Es un porcentaje del precio representado como un número en notación decimal (por ejemplo, |
carrierRate |
Es el nombre de una tarifa de la empresa de transporte que hace referencia a una tarifa de la empresa de transporte definida en el mismo grupo de tarifas. Solo se puede establecer si no están configurados todos los demás campos. |
subtable |
Es el nombre de una tabla secundaria. Solo se puede establecer en celdas de tabla (por ejemplo, no para valores individuales) y solo si no se configuran todos los demás campos. |
Tabla
Una tabla que define el grupo de tarifas, cuando singleValue
no es lo suficientemente expresivo.
Representación JSON |
---|
{ "rows": [ { object ( |
Campos | |
---|---|
rows[] |
Obligatorio. Es la lista de filas que conforman la tabla. Debe tener la misma longitud que |
name |
Es el nombre de la tabla. Obligatorio para las tablas secundarias; se ignora para la tabla principal. |
rowHeaders |
Obligatorio. Encabezados de las filas de la tabla. |
columnHeaders |
Encabezados de las columnas de la tabla. Opcional: Si no se establece, la tabla tiene solo una dimensión. |
Encabezados
Es una lista no vacía de encabezados de fila o columna de una tabla. Se debe establecer exactamente uno de los siguientes valores: prices
, weights
, num_items
, postalCodeGroupNames
o location
.
Representación JSON |
---|
{ "prices": [ { object ( |
Campos | |
---|---|
prices[] |
Obligatorio. Una lista de los límites superiores de precios de los pedidos inclusivos. El valor del último precio puede ser infinito si se establece price amountMicros = -1. Por ejemplo, |
weights[] |
Obligatorio. Una lista de los límites superiores del peso de orden inclusivo. El último valor de la ponderación puede ser infinito si se establece priceMicros = -1. Por ejemplo, |
numberOfItems[] |
Obligatorio. Es una lista de límites superiores inclusivos de la cantidad de elementos. El último valor puede ser |
postalCodeGroupNames[] |
Obligatorio. Es una lista de nombres de grupos postales. El último valor puede ser |
locations[] |
Obligatorio. Es una lista de conjuntos de IDs de ubicación. No puede estar vacío. Solo se puede configurar si no se establecieron todos los demás campos. |
Peso
El peso representado como el valor en la cadena y en la unidad.
Representación JSON |
---|
{
"unit": enum ( |
Campos | |
---|---|
unit |
Obligatorio. La unidad de peso. Los valores aceptables son: kg y lb. |
amountMicros |
Obligatorio. Es el peso representado como un número en micros (1 millón de micros equivale a la unidad estándar de la moneda, por ejemplo, 1 kg = 1000000 micros). Este campo también se puede establecer como infinito si se establece en -1. Este campo solo admite -1 y valor positivo. |
WeightUnit
La unidad de peso.
Enumeraciones | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unidad sin especificar |
POUND |
lb. |
KILOGRAM |
kg. |
LocationIdSet
Es una lista de conjuntos de ID de ubicación. No debe estar vacío. Solo se puede establecer si no están configurados todos los demás campos.
Representación JSON |
---|
{ "locationIds": [ string ] } |
Campos | |
---|---|
locationIds[] |
Obligatorio. Una lista no vacía de IDs de ubicación. Todas deben ser del mismo tipo de ubicación (por ejemplo, estado). |
Fila
Incluye una lista de celdas.
Representación JSON |
---|
{
"cells": [
{
object ( |
Campos | |
---|---|
cells[] |
Obligatorio. Lista de celdas que constituyen la fila. Debe tener la misma longitud que |
CarrierRate
Es una lista de las tarifas de la empresa de transporte a las que se puede hacer referencia mediante mainTable
o singleValue
.
Representación JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Campos | |
---|---|
name |
Obligatorio. Indica el nombre de la tarifa de la empresa de transporte. Debe ser único por grupo de tarifas. |
carrier |
Obligatorio. Servicio de operador, como |
carrierService |
Obligatorio. Servicio de operador, como |
originPostalCode |
Obligatorio. Es el origen de envío para esta tarifa del transportista. |
percentageAdjustment |
Opcional. Es el modificador multiplicativo de la tarifa de envío como un número en notación decimal. Puede ser negativo. Por ejemplo, |
flatAdjustment |
Opcional. Modificador aditivo de tarifa de envío. Puede ser negativo. Por ejemplo, |
ShipmentType
Es el tipo de envío del servicio de envío.
Enumeraciones | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Este servicio no especificó el tipo de envío. |
DELIVERY |
Con este servicio, se envían los pedidos a una dirección que elige el cliente. |
LOCAL_DELIVERY |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde una tienda local cercana. |
COLLECTION_POINT |
Este servicio envía los pedidos a una dirección elegida por el cliente. El pedido se envía desde un punto de recolección. |
MinimumOrderValueTable
Tabla de los valores de pedido mínimos por tienda para el tipo de entrega de retiro.
Representación JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campos | |
---|---|
storeCodeSetWithMovs[] |
Obligatorio. Es una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo del pedido (MOV). Se requieren al menos dos conjuntos, y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda. |
StoreCodeSetWithMov
Una lista de conjuntos de códigos de tienda que comparten el mismo valor mínimo de pedido Se requieren al menos dos conjuntos y el último debe estar vacío, lo que significa "MOV para todas las demás tiendas". Cada código de tienda solo puede aparecer una vez en todos los conjuntos. Todos los precios de un servicio deben tener la misma moneda.
Representación JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Es una lista de códigos de tienda únicos o vacía para la opción de todo. |
value |
Es el valor mínimo de pedido para las tiendas determinadas. |
StoreConfig
Una lista de las tiendas desde las que se entregan tus productos. Esto solo es válido para el tipo de envío de entrega local.
Representación JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Es una lista de códigos de tienda que proporcionan entrega local. Si está vacío, |
storeServiceType |
Indica si todas las tiendas, o las seleccionadas, que figuran en la ficha de este comercio ofrecen entrega local. |
cutoffConfig |
Las configuraciones relacionadas con la entrega local finalizan por el día. |
serviceRadius |
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío de entrega local. |
StoreServiceType
Indica si todas las tiendas, o las seleccionadas, que enumera el comercio ofrecen entrega local.
Enumeraciones | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
No se especificó el tipo de servicio de la tienda. |
ALL_STORES |
Indica si todas las tiendas, actuales y futuras, de este comercio, ofrecen servicio de entrega local. |
SELECTED_STORES |
Indica que solo las tiendas que se indican en storeCodes son aptas para la entrega local. |
CutoffConfig
Las configuraciones relacionadas con la entrega local finalizan por el día.
Representación JSON |
---|
{
"localCutoffTime": {
object ( |
Campos | |
---|---|
localCutoffTime |
Hora a la que finaliza la entrega local el día. |
storeCloseOffsetHours |
Solo es válido con la entrega de entregas locales. Representa el horario límite como la cantidad de horas previas al cierre de la tienda. Este campo y |
noDeliveryPostCutoff |
Los comercios pueden inhabilitar la opción de mostrar la entrega local en n+1 días cuando tienen un servicio de envío configurado para la entrega local en n días. Por ejemplo, si el servicio de envío define la entrega el mismo día y ya pasó la hora límite, establecer este campo en |
LocalCutoffTime
Hora en la que finaliza la entrega local del día.
Representación JSON |
---|
{ "hour": string, "minute": string } |
Campos | |
---|---|
hour |
Los pedidos con entrega local a la hora deben realizarse hasta el mismo día para que se procesen. |
minute |
Los pedidos de entrega local en minutos deben realizarse antes de esta hora para que se procesen el mismo día. |
Distancia
Radio de entrega máximo. Esto solo es obligatorio para el tipo de envío con entrega local.
Representación JSON |
---|
{
"value": string,
"unit": enum ( |
Campos | |
---|---|
value |
Valor entero de la distancia. |
unit |
La unidad puede variar según el país, ya que está parametrizada para incluir millas y kilómetros. |
Unidad
La unidad puede variar según el país, se parametriza para incluir millas y kilómetros.
Enumeraciones | |
---|---|
UNIT_UNSPECIFIED |
Unidad sin especificar |
MILES |
Unidad en millas |
KILOMETERS |
Unidad en kilómetros |
LoyaltyProgram
Programa de lealtad proporcionado por un comercio.
Representación JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
Campos | |
---|---|
loyaltyProgramTiers[] |
Opcional. Es el nivel del programa de lealtad de este servicio de envío. |
programLabel |
Es la etiqueta del programa de lealtad establecida en la configuración de tu programa de lealtad en Merchant Center. Este atributo secundario permite que Google asigne tu programa de lealtad a las ofertas aptas. |
LoyaltyProgramTiers
Subconjunto de un programa de lealtad de comercios.
Representación JSON |
---|
{ "tierLabel": string } |
Campos | |
---|---|
tierLabel |
El atributo secundario etiqueta de nivel [tierLabel] diferencia los beneficios del nivel de oferta entre cada nivel. Este valor también se establece en la configuración del programa en Merchant Center y es obligatorio para realizar cambios en la fuente de datos, incluso si tu programa de lealtad solo tiene 1 nivel. |
Almacén
Un almacén de entrega, que almacena y maneja inventario Etiqueta siguiente: 7
Representación JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campos | |
---|---|
name |
Obligatorio. El nombre del almacén Debe ser único en la cuenta. |
shippingAddress |
Obligatorio. Dirección de envío del almacén. |
cutoffTime |
Obligatorio. El último momento del día en que se puede aceptar un pedido y comenzar a procesarse. Los pedidos posteriores se procesarán al día siguiente. La hora se basa en el código postal del almacén. |
handlingDays |
Obligatorio. Es la cantidad de días que tarda este almacén en empacar y enviar un artículo. Esto se encuentra a nivel del almacén, pero se puede anular a nivel de la oferta según los atributos de un artículo. |
businessDayConfig |
Son los días hábiles del almacén. Si no se establece, será de lunes a viernes de forma predeterminada. |
Dirección
Es la dirección de envío del almacén.
Representación JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
Campos | |
---|---|
streetAddress |
Parte de la dirección a nivel de la calle Por ejemplo: |
city |
Obligatorio. Ciudad, pueblo o comuna. También puede incluir localidades o sublocalidades dependientes (por ejemplo, vecindarios o suburbios). |
administrativeArea |
Obligatorio. Es la subdivisión administrativa principal del país. Por ejemplo, puede ser un estado como California ("CA") o una provincia como Quebec ("QC"). |
postalCode |
Obligatorio. Es el código postal (por ejemplo, “94043”). |
regionCode |
Obligatorio. Código de país de CLDR (por ejemplo, “US”). |
WarehouseCutoffTime
Es la hora del día más tarde a la que se puede aceptar un pedido y comenzar a procesarlo. Los pedidos posteriores se procesarán al día siguiente. El horario se basa en el código postal del almacén.
Representación JSON |
---|
{ "hour": integer, "minute": integer } |
Campos | |
---|---|
hour |
Obligatorio. Es la hora del horario límite hasta la que se debe realizar un pedido para que el almacén lo procese el mismo día. La hora se basa en la zona horaria del almacén. |
minute |
Obligatorio. Minuto del horario límite hasta el que se debe realizar un pedido para que el almacén lo procese el mismo día. El minuto se basa en la zona horaria del almacén. |