REST Resource: accounts.shippingSettings

Recurso: ShippingSettings

A configuração de frete da conta do comerciante.

Representação JSON
{
  "name": string,
  "services": [
    {
      object (Service)
    }
  ],
  "warehouses": [
    {
      object (Warehouse)
    }
  ],
  "etag": string
}
Campos
name

string

Identificador. O nome do recurso da configuração de frete. Formato: accounts/{account}/shippingSetting

services[]

object (Service)

Opcional. A lista de serviços da conta de destino.

warehouses[]

object (Warehouse)

Opcional. Uma lista de depósitos que podem ser referenciados em services.

etag

string

Obrigatório. Esse campo é usado para evitar problemas assíncronos. Verifique se os dados de configuração de frete não mudaram entre as chamadas de recebimento e inserção. O usuário precisa seguir estas etapas:

  1. O campo etag foi definido como uma string vazia para a criação inicial da configuração de frete.

  2. Após a criação inicial, chame o método "get" para receber um ETag e os dados de configuração de envio atuais antes de inserir a chamada.

  3. Modifique para as informações de configuração de frete desejadas.

  4. Chame o método de inserção com as informações de configuração de frete desejadas com a ETag obtida na etapa 2.

  5. Se os dados de configuração de frete mudaram entre a etapa 2 e a 4. A solicitação de inserção vai falhar porque o ETag muda sempre que os dados da configuração de frete mudam. O usuário precisa repetir as etapas de 2 a 4 com o novo etag.

Serviço

Serviço de frete.

Representação JSON
{
  "deliveryCountries": [
    string
  ],
  "rateGroups": [
    {
      object (RateGroup)
    }
  ],
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "serviceName": string,
  "active": boolean,
  "currencyCode": string,
  "deliveryTime": {
    object (DeliveryTime)
  },
  "shipmentType": enum (ShipmentType),
  "minimumOrderValue": {
    object (Price)
  },
  "minimumOrderValueTable": {
    object (MinimumOrderValueTable)
  },
  "storeConfig": {
    object (StoreConfig)
  }
}
Campos
deliveryCountries[]

string

Obrigatório. O código de território CLDR dos países a que o serviço se aplica.

rateGroups[]

object (RateGroup)

Opcional. Definições do grupo de taxas de frete. Apenas o último pode ter um applicableShippingLabels vazio, o que significa "tudo o mais". As outras applicableShippingLabels não podem se sobrepor.

loyaltyPrograms[]

object (LoyaltyProgram)

Opcional. Programas de fidelidade a que esse serviço de frete está limitado.

serviceName

string

Obrigatório. Nome do serviço em formato livre. Precisa ser exclusivo na conta de destino.

active

boolean

Obrigatório. Um booleano que expõe o status ativo do serviço de frete.

currencyCode

string

O código CLDR da moeda a que este serviço se aplica. Precisa corresponder ao dos preços nos grupos de tarifas.

deliveryTime

object (DeliveryTime)

Obrigatório. Tempo gasto em vários aspectos, desde o pedido até a entrega do produto.

shipmentType

enum (ShipmentType)

Tipo de local para onde o serviço envia pedidos.

minimumOrderValue

object (Price)

Valor mínimo do pedido para esse serviço. Se definido, indica que os clientes precisam gastar pelo menos esse valor. Todos os preços em um serviço precisam ter a mesma moeda. Não pode ser definido com a tabela minimumOrderValueTable.

minimumOrderValueTable

object (MinimumOrderValueTable)

Tabela de valores mínimos de pedidos por loja para o tipo de fulfillment de retirada. Não pode ser definido com minimumOrderValue.

storeConfig

object (StoreConfig)

Uma lista de lojas de onde os produtos são enviados. Isso é válido apenas para o tipo de envio de entrega local.

DeliveryTime

Tempo gasto em vários aspectos, desde o pedido até a entrega do produto.

Representação JSON
{
  "warehouseBasedDeliveryTimes": [
    {
      object (WarehouseBasedDeliveryTime)
    }
  ],
  "minTransitDays": integer,
  "maxTransitDays": integer,
  "cutoffTime": {
    object (CutoffTime)
  },
  "minHandlingDays": integer,
  "maxHandlingDays": integer,
  "transitTimeTable": {
    object (TransitTable)
  },
  "handlingBusinessDayConfig": {
    object (BusinessDayConfig)
  },
  "transitBusinessDayConfig": {
    object (BusinessDayConfig)
  }
}
Campos
warehouseBasedDeliveryTimes[]

object (WarehouseBasedDeliveryTime)

Opcional. Indica que o tempo de entrega deve ser calculado por armazém (local de origem do frete) com base nas configurações da transportadora selecionada. Quando definido, nenhum outro campo relacionado ao tempo de trânsito em [tempo de entrega][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] precisa ser definido.

minTransitDays

integer

Número mínimo de dias úteis que são gastos em trânsito. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. É necessário definir minTransitDays, maxTransitDays ou transitTimeTable, mas não ambos.

maxTransitDays

integer

Número máximo de dias úteis que são gastos em trânsito. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. Precisa ser maior ou igual a minTransitDays.

cutoffTime

object (CutoffTime)

Definição do horário limite dos dias úteis. Se não for configurado, o horário limite será 8h no horário padrão do Pacífico.

minHandlingDays

integer

Número mínimo de dias úteis gastos antes do envio de um pedido. 0 significa envio no mesmo dia e 1 significa envio no dia seguinte. Os campos "minHandlingDays" e "maxHandlingDays" precisam ser definidos ou não ao mesmo tempo.

maxHandlingDays

integer

Número máximo de dias úteis gastos antes do envio de um pedido. 0 significa envio no mesmo dia e 1 significa envio no dia seguinte. Precisa ser maior ou igual a minHandlingDays. Os campos "minHandlingDays" e "maxHandlingDays" precisam ser definidos ou não ao mesmo tempo.

transitTimeTable

object (TransitTable)

Tabela de tempo de trânsito, número de dias úteis gastos em trânsito com base nas dimensões de linha e coluna. É possível definir minTransitDays, maxTransitDays ou transitTimeTable, mas não ambos.

handlingBusinessDayConfig

object (BusinessDayConfig)

Os dias úteis em que os pedidos podem ser processados. Se não forem informados, os dias úteis de segunda a sexta-feira serão considerados.

transitBusinessDayConfig

object (BusinessDayConfig)

Os dias úteis em que os pedidos podem estar em trânsito. Se não forem informados, os dias úteis de segunda a sexta-feira serão considerados.

CutoffTime

Definição do horário limite dos dias úteis.

Representação JSON
{
  "hour": integer,
  "minute": integer,
  "timeZone": string
}
Campos
hour

integer

Obrigatório. Horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia.

minute

integer

Obrigatório. Minuto do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia.

timeZone

string

Obrigatório. Identificador de fuso horário. Por exemplo, "Europe/Zurich".

TransitTable

Tabela de tempo de trânsito, número de dias úteis gastos em trânsito com base nas dimensões de linha e coluna. É possível definir minTransitDays, maxTransitDays ou transitTimeTable, mas não ambos.

Representação JSON
{
  "postalCodeGroupNames": [
    string
  ],
  "transitTimeLabels": [
    string
  ],
  "rows": [
    {
      object (TransitTimeRow)
    }
  ]
}
Campos
postalCodeGroupNames[]

string

Obrigatório. Uma lista de nomes de regiões Region.name . O último valor pode ser "all other locations". Exemplo: ["zone 1", "zone 2", "all other locations"]. Os grupos de códigos postais indicados precisam corresponder ao país de entrega do serviço.

transitTimeLabels[]

string

Obrigatório. Uma lista de rótulos de tempo em trânsito. O último valor pode ser "all other labels". Exemplo: ["food", "electronics", "all other labels"].

rows[]

object (TransitTimeRow)

Obrigatório. Se houver apenas um conjunto de dimensões de postalCodeGroupNames ou transitTimeLabels, haverá várias linhas, cada uma com um valor para essa dimensão. Se houver duas dimensões, cada linha corresponde a uma postalCodeGroupNames e as colunas (valores) a uma transitTimeLabels.

TransitTimeRow

Se houver apenas um conjunto de dimensões de postalCodeGroupNames ou transitTimeLabels, haverá várias linhas, cada uma com um valor para essa dimensão. Se houver duas dimensões, cada linha corresponde a uma postalCodeGroupNames e as colunas (valores) a uma transitTimeLabels.

Representação JSON
{
  "values": [
    {
      object (TransitTimeValue)
    }
  ]
}
Campos
values[]

object (TransitTimeValue)

Obrigatório. Período de tempo em trânsito (mínimo-máximo) em dias úteis.

TransitTimeValue

Período de tempo em trânsito (mínimo-máximo) em dias úteis.

Representação JSON
{
  "minTransitDays": integer,
  "maxTransitDays": integer
}
Campos
minTransitDays

integer

Período mínimo de trânsito em dias úteis. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte.

maxTransitDays

integer

Precisa ser maior ou igual a minTransitDays.

BusinessDayConfig

Dias úteis do armazém.

Representação JSON
{
  "businessDays": [
    enum (Weekday)
  ]
}
Campos
businessDays[]

enum (Weekday)

Obrigatório. Dias úteis regulares. Não pode estar vazio.

Dia da semana

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

WarehouseBasedDeliveryTime

Indica que o tempo de entrega deve ser calculado por armazém (local de origem do frete) com base nas configurações da transportadora selecionada. Quando definido, nenhum outro campo relacionado ao tempo de trânsito em deliveryTime pode ser definido.

Representação JSON
{
  "carrier": string,
  "carrierService": string,
  "warehouse": string
}
Campos
carrier

string

Obrigatório. Operadora, como "UPS" ou "Fedex". operadoras compatíveis

carrierService

string

Obrigatório. Serviço de operadora, como "ground" ou "2 days". O nome do serviço precisa estar na lista eddSupportedServices.

warehouse

string

Obrigatório. Nome do warehouse. Ele precisa corresponder a [warehouse][ShippingSetting.warehouses.name]

RateGroup

Definições do grupo de taxas de frete. Apenas o último pode ter um applicableShippingLabels vazio, o que significa "tudo o mais". As outras applicableShippingLabels não podem se sobrepor.

Representação JSON
{
  "applicableShippingLabels": [
    string
  ],
  "subtables": [
    {
      object (Table)
    }
  ],
  "carrierRates": [
    {
      object (CarrierRate)
    }
  ],
  "singleValue": {
    object (Value)
  },
  "mainTable": {
    object (Table)
  },
  "name": string
}
Campos
applicableShippingLabels[]

string

Obrigatório. Uma lista de rótulos para envio que define os produtos a que esse grupo de tarifas se aplica. Esta é uma disjunção: apenas um dos rótulos precisa corresponder para que o grupo de tarifas seja aplicado. Só pode estar vazio para o último grupo de tarifas de um serviço.

subtables[]

object (Table)

Opcional. Uma lista de subtabelas referenciadas por mainTable. Só pode ser definido se mainTable estiver definido.

carrierRates[]

object (CarrierRate)

Opcional. Uma lista de tarifas da operadora que pode ser referenciada por mainTable ou singleValue.

singleValue

object (Value)

O valor do grupo de tarifas (por exemplo, tarifa fixa de US $10). Só pode ser definido se mainTable e subtables não estiverem definidos.

mainTable

object (Table)

Uma tabela que define o grupo de tarifas, quando singleValue não é expressivo o suficiente. Só pode ser definido se singleValue não estiver definido.

name

string

Opcional. Nome do grupo de tarifas. Se definido, o ID precisa ser exclusivo no serviço de frete.

Valor

O valor único de um grupo de tarifas ou o valor da célula de uma tabela de grupo de tarifas. Exatamente um dos seguintes valores precisa ser definido: noShipping, flatRate, pricePercentage, carrier_rateName, subtable_name.

Representação JSON
{
  "noShipping": boolean,
  "flatRate": {
    object (Price)
  },
  "pricePercentage": string,
  "carrierRate": string,
  "subtable": string
}
Campos
noShipping

boolean

Se for verdadeiro, o produto não poderá ser enviado. Precisa ser verdadeiro quando definido e só pode ser definido se todos os outros campos não estiverem definidos.

flatRate

object (Price)

Uma taxa fixa. Só pode ser definido se todos os outros campos não estiverem definidos.

pricePercentage

string

Uma porcentagem do preço representada como um número em notação decimal (por exemplo, "5.4"). Só pode ser definido se todos os outros campos não estiverem definidos.

carrierRate

string

O nome de uma tarifa de transportadora que se refere a uma tarifa de transportadora definida no mesmo grupo de tarifas. Só pode ser definido se todos os outros campos não estiverem definidos.

subtable

string

O nome de uma subtabela. Só pode ser definido em células de tabela (por exemplo, não para valores únicos) e somente se todos os outros campos não estiverem definidos.

Tabela

Uma tabela que define o grupo de tarifas, quando singleValue não é expressivo o suficiente.

Representação JSON
{
  "rows": [
    {
      object (Row)
    }
  ],
  "name": string,
  "rowHeaders": {
    object (Headers)
  },
  "columnHeaders": {
    object (Headers)
  }
}
Campos
rows[]

object (Row)

Obrigatório. A lista de linhas que constituem a tabela. Precisa ter o mesmo comprimento de rowHeaders.

name

string

Nome da tabela. Obrigatório para subtabelas, ignorado para a tabela principal.

rowHeaders

object (Headers)

Obrigatório. Cabeçalhos das linhas da tabela.

columnHeaders

object (Headers)

Cabeçalhos das colunas da tabela. Opcional: se não for definido, a tabela terá apenas uma dimensão.

Cabeçalhos

Uma lista não vazia de cabeçalhos de linha ou coluna de uma tabela. Exatamente um entre prices, weights, num_items, postalCodeGroupNames ou location precisa ser definido.

Representação JSON
{
  "prices": [
    {
      object (Price)
    }
  ],
  "weights": [
    {
      object (Weight)
    }
  ],
  "numberOfItems": [
    string
  ],
  "postalCodeGroupNames": [
    string
  ],
  "locations": [
    {
      object (LocationIdSet)
    }
  ]
}
Campos
prices[]

object (Price)

Obrigatório. Uma lista de limites máximos de preço de pedidos com tributos. O valor do último preço pode ser infinito definindo price amountMicros = -1. Por exemplo, [{"amountMicros": 10000000, "currencyCode": "USD"}, {"amountMicros": 500000000, "currencyCode": "USD"}, {"amountMicros": -1, "currencyCode": "USD"}] representa os cabeçalhos "<= $10", "<= $500" e "> $500". Todos os preços em um serviço precisam ter a mesma moeda. Precisa estar preenchido. Precisa ser positivo, exceto -1. Só pode ser definido se todos os outros campos não estiverem definidos.

weights[]

object (Weight)

Obrigatório. Uma lista de limites máximos de peso de pedidos inclusivos. O valor do último peso pode ser infinito definindo price amountMicros = -1. Por exemplo, [{"amountMicros": 10000000, "unit": "kg"}, {"amountMicros": 50000000, "unit": "kg"}, {"amountMicros": -1, "unit": "kg"}] representa os cabeçalhos "<= 10kg", "<= 50kg" e "> 50kg". Todos os pesos em um serviço precisam ter a mesma unidade. Precisa estar preenchido. Precisa ser positivo, exceto -1. Só pode ser definido se todos os outros campos não estiverem definidos.

numberOfItems[]

string

Obrigatório. Uma lista de número de limites superiores de itens inclusivos. O último valor pode ser "infinity". Por exemplo, ["10", "50", "infinity"] representa os cabeçalhos "<= 10 itens", "<= 50 itens" e "> 50 itens". Precisa estar preenchido. Só pode ser definido se todos os outros campos não estiverem definidos.

postalCodeGroupNames[]

string

Obrigatório. Uma lista de nomes de grupos postais. O último valor pode ser "all other locations". Exemplo: ["zone 1", "zone 2", "all other locations"]. Os grupos de códigos postais indicados precisam corresponder ao país de entrega do serviço. Precisa estar preenchido. Só pode ser definido se todos os outros campos não estiverem definidos.

locations[]

object (LocationIdSet)

Obrigatório. Uma lista de conjuntos de IDs de local. Precisa estar preenchido. Só pode ser definido se todos os outros campos não estiverem definidos.

Peso

O peso representado como o valor em string e a unidade.

Representação JSON
{
  "unit": enum (WeightUnit),
  "amountMicros": string
}
Campos
unit

enum (WeightUnit)

Obrigatório. A unidade de peso. Os valores aceitáveis são: kg e lb

amountMicros

string (int64 format)

Obrigatório. O peso representado como um número em micros (1 milhão de micros é equivalente a uma unidade padrão de moeda, por exemplo, 1 kg = 1.000.000 micros). Esse campo também pode ser definido como infinito, definindo -1. Este campo só aceita -1 e valor positivo.

WeightUnit

A unidade de peso.

Enums
WEIGHT_UNIT_UNSPECIFIED unidade não especificada
POUND unidade lb.
KILOGRAM unidade kg.

LocationIdSet

Uma lista de conjuntos de IDs de local. Precisa estar preenchido. Só pode ser definido se todos os outros campos não estiverem definidos.

Representação JSON
{
  "locationIds": [
    string
  ]
}
Campos
locationIds[]

string

Obrigatório. Uma lista não vazia de IDs de local. Elas precisam ser do mesmo tipo de local (por exemplo, estado).

Linha

Inclua uma lista de células.

Representação JSON
{
  "cells": [
    {
      object (Value)
    }
  ]
}
Campos
cells[]

object (Value)

Obrigatório. A lista de células que constituem a linha. Precisa ter o mesmo comprimento de columnHeaders para tabelas bidimensionais e um comprimento de 1 para tabelas unidimensionais.

CarrierRate

Uma lista de tarifas da operadora que pode ser referenciada por mainTable ou singleValue. Os serviços de operadoras com suporte estão definidos em https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Representação JSON
{
  "name": string,
  "carrier": string,
  "carrierService": string,
  "originPostalCode": string,
  "percentageAdjustment": string,
  "flatAdjustment": {
    object (Price)
  }
}
Campos
name

string

Obrigatório. Nome da tarifa da operadora. Precisa ser exclusivo por grupo de tarifas.

carrier

string

Obrigatório. Serviço de operadora, como "UPS" ou "Fedex".

carrierService

string

Obrigatório. Serviço de operadora, como "ground" ou "2 days".

originPostalCode

string

Obrigatório. Origem do envio para essa tarifa da transportadora.

percentageAdjustment

string

Opcional. Modificador multiplicativo da taxa de frete como um número em notação decimal. Pode ser negativo. Por exemplo, "5.4" aumenta a taxa em 5,4%, e "-3" diminui a taxa em 3%.

flatAdjustment

object (Price)

Opcional. Modificador aditivo da taxa de frete. Pode ser negativo. Por exemplo, { "amountMicros": 1, "currencyCode" : "USD" } adiciona US $1 à taxa, e { "amountMicros": -3, "currencyCode" : "USD" } remove US $3 da taxa.

ShipmentType

Tipo de frete do serviço de frete.

Enums
SHIPMENT_TYPE_UNSPECIFIED Este serviço não especificou o tipo de envio.
DELIVERY Esse serviço envia pedidos para um endereço escolhido pelo cliente.
LOCAL_DELIVERY Esse serviço envia pedidos para um endereço escolhido pelo cliente. O pedido é enviado de uma loja local próxima.
COLLECTION_POINT Esse serviço envia pedidos para um endereço escolhido pelo cliente. O pedido é enviado de um ponto de coleta.

MinimumOrderValueTable

Tabela de valores mínimos de pedidos por loja para o tipo de fulfillment de retirada.

Representação JSON
{
  "storeCodeSetWithMovs": [
    {
      object (StoreCodeSetWithMov)
    }
  ]
}
Campos
storeCodeSetWithMovs[]

object (StoreCodeSetWithMov)

Obrigatório. Uma lista de conjuntos de códigos da loja que compartilham o mesmo valor mínimo do pedido (MOV). Pelo menos dois conjuntos são necessários, e o último precisa estar vazio, o que significa "MOV para todas as outras lojas". Cada código da loja só pode aparecer uma vez em todos os conjuntos. Todos os preços em um serviço precisam ter a mesma moeda.

StoreCodeSetWithMov

Uma lista de conjuntos de códigos de loja que compartilham o mesmo valor mínimo do pedido. Pelo menos dois conjuntos são necessários, e o último precisa estar vazio, o que significa "MOV para todas as outras lojas". Cada código da loja só pode aparecer uma vez em todos os conjuntos. Todos os preços em um serviço precisam ter a mesma moeda.

Representação JSON
{
  "storeCodes": [
    string
  ],
  "value": {
    object (Price)
  }
}
Campos
storeCodes[]

string

Opcional. Uma lista de códigos de loja exclusivos ou vazia para o catch-all.

value

object (Price)

O valor mínimo do pedido para as lojas.

StoreConfig

Uma lista de lojas de onde os produtos são enviados. Isso é válido apenas para o tipo de envio de entrega local.

Representação JSON
{
  "storeCodes": [
    string
  ],
  "storeServiceType": enum (StoreServiceType),
  "cutoffConfig": {
    object (CutoffConfig)
  },
  "serviceRadius": {
    object (Distance)
  }
}
Campos
storeCodes[]

string

Opcional. Uma lista de códigos de lojas que oferecem entrega local. Se estiver vazio, all_stores precisa ser verdadeiro.

storeServiceType

enum (StoreServiceType)

Indica se todas as lojas ou lojas selecionadas listadas pelo comerciante oferecem entrega local.

cutoffConfig

object (CutoffConfig)

As configurações relacionadas à entrega local são encerradas para o dia.

serviceRadius

object (Distance)

Raio máximo de entrega. Isso é necessário apenas para o tipo de envio de entrega local.

StoreServiceType

Indica se todas as lojas ou apenas algumas das listadas pelo comerciante oferecem entrega local.

Enums
STORE_SERVICE_TYPE_UNSPECIFIED Não especificou o tipo de serviço da loja.
ALL_STORES Indica se todas as lojas, atuais e futuras, listadas pelo comerciante oferecem entrega local.
SELECTED_STORES Indica que apenas as lojas listadas em storeCodes estão qualificadas para entrega local.

CutoffConfig

As configurações relacionadas à entrega local são encerradas para o dia.

Representação JSON
{
  "localCutoffTime": {
    object (LocalCutoffTime)
  },
  "storeCloseOffsetHours": string,
  "noDeliveryPostCutoff": boolean
}
Campos
localCutoffTime

object (LocalCutoffTime)

Hora em que a entrega local termina no dia.

storeCloseOffsetHours

string (int64 format)

Válido apenas para fulfillment de entrega local. Representa o horário limite como o número de horas antes do fechamento da loja. Mutuamente exclusivo com localCutoffTime.

noDeliveryPostCutoff

boolean

Os comerciantes podem desativar a exibição da entrega local em n+1 dia quando têm um serviço de frete configurado para a entrega local em n dias. Por exemplo, se o serviço de frete definir a entrega no mesmo dia e o prazo tiver passado, definir esse campo como true fará com que a taxa do serviço de frete calculada retorne NO_DELIVERY_POST_CUTOFF. No mesmo exemplo, definir esse campo como false faz com que o tempo de envio calculado seja de um dia. Isso é válido apenas para entrega local.

LocalCutoffTime

Hora em que a entrega local termina no dia.

Representação JSON
{
  "hour": string,
  "minute": string
}
Campos
hour

string (int64 format)

Os pedidos de entrega local em uma hora precisam ser feitos até esse horário para serem processados no mesmo dia.

minute

string (int64 format)

Os pedidos de entrega local precisam ser feitos até esse horário para serem processados no mesmo dia.

Distância

Raio máximo de entrega. Isso é necessário apenas para o tipo de envio de entrega local.

Representação JSON
{
  "value": string,
  "unit": enum (Unit)
}
Campos
value

string (int64 format)

Valor inteiro da distância.

unit

enum (Unit)

A unidade pode variar de acordo com o país e é parametrizada para incluir milhas e quilômetros.

Unidade

A unidade pode variar de acordo com o país e é parametrizada para incluir milhas e quilômetros.

Enums
UNIT_UNSPECIFIED Unidade não especificada
MILES Unidade em milhas
KILOMETERS Unidade em quilômetros

LoyaltyProgram

Programa de fidelidade fornecido por um comerciante.

Representação JSON
{
  "loyaltyProgramTiers": [
    {
      object (LoyaltyProgramTiers)
    }
  ],
  "programLabel": string
}
Campos
loyaltyProgramTiers[]

object (LoyaltyProgramTiers)

Opcional. Nível do programa de fidelidade deste serviço de frete.

programLabel

string

Este é o rótulo do programa de fidelidade definido nas configurações correspondentes no Merchant Center. Esse subatributo permite que o Google mapeie o programa de fidelidade para ofertas qualificadas.

LoyaltyProgramTiers

Subconjunto de um programa de fidelidade do comerciante.

Representação JSON
{
  "tierLabel": string
}
Campos
tierLabel

string

O subatributo rótulo do nível [tierLabel] diferencia os benefícios do nível da oferta entre cada nível. Esse valor também é definido nas configurações do programa no Merchant Center e é obrigatório para mudanças na fonte de dados, mesmo que seu programa de fidelidade tenha apenas um nível.

Depósito

Um depósito de atendimento, que armazena e processa o inventário.

Representação JSON
{
  "name": string,
  "shippingAddress": {
    object (Address)
  },
  "cutoffTime": {
    object (WarehouseCutoffTime)
  },
  "handlingDays": string,
  "businessDayConfig": {
    object (BusinessDayConfig)
  }
}
Campos
name

string

Obrigatório. O nome do warehouse. Precisa ser exclusivo na conta.

shippingAddress

object (Address)

Obrigatório. Endereço de entrega do depósito.

cutoffTime

object (WarehouseCutoffTime)

Obrigatório. O horário mais tarde do dia em que um pedido pode ser aceito e começar a ser processado. Os pedidos posteriores serão processados no dia seguinte. O tempo é baseado no código postal do depósito.

handlingDays

string (int64 format)

Obrigatório. O número de dias que o depósito leva para embalar e enviar um item. Isso está no nível do depósito, mas pode ser substituído no nível da oferta com base nos atributos de um item.

businessDayConfig

object (BusinessDayConfig)

Dias úteis do armazém. Se não for definido, será de segunda a sexta-feira por padrão.

Endereço

Endereço de entrega do depósito.

Representação JSON
{
  "streetAddress": string,
  "city": string,
  "administrativeArea": string,
  "postalCode": string,
  "regionCode": string
}
Campos
streetAddress

string

Parte do endereço referente à rua. Por exemplo, 111w 31st Street.

city

string

Obrigatório. Cidade, município ou comuna. Também pode incluir localidades ou sublocalidades dependentes (por exemplo, bairros ou subúrbios).

administrativeArea

string

Obrigatório. Subdivisão administrativa de nível superior do país. Por exemplo, um estado como a Califórnia ("CA") ou uma província como Quebec ("QC").

postalCode

string

Obrigatório. Código postal ou CEP (por exemplo, "94043").

regionCode

string

Obrigatório. Código de país CLDR (por exemplo, "US").

WarehouseCutoffTime

O horário mais tarde do dia em que um pedido pode ser aceito e começar a ser processado. Os pedidos posteriores serão processados no dia seguinte. O tempo é baseado no código postal do depósito.

Representação JSON
{
  "hour": integer,
  "minute": integer
}
Campos
hour

integer

Obrigatório. Hora do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia pelo depósito. A hora é baseada no fuso horário do depósito.

minute

integer

Obrigatório. Minuto do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia pelo depósito. O minuto é baseado no fuso horário do depósito.

Métodos

getShippingSettings

Extrair informações das configurações de frete.

insert

Substitua a configuração de frete de um comerciante pela configuração de frete de solicitação.