- Representação JSON
- Serviço
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Dias úteis
- WarehouseBasedDeliveryTime
- RateGroup
- Valor
- Table
- Cabeçalhos
- Peso
- WeightUnit
- LocationIdSet
- Linha
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distância
- Unidade
- LoyaltyProgram
- LoyaltyProgramTiers
- Depósito
- Endereço
- WarehouseCutoffTime
A configuração de frete da conta do comerciante.
Representação JSON |
---|
{ "name": string, "services": [ { object ( |
Campos | |
---|---|
name |
Identificador. O nome do recurso da configuração de frete. Formato: |
services[] |
Opcional. A lista de serviços da conta de destino. |
warehouses[] |
Opcional. Uma lista de depósitos que podem ser referenciados em |
etag |
Obrigatório. Esse campo é usado para evitar problemas assíncronos. Verifique se os dados das configurações de frete não foram alterados entre "Receber chamada" e "Inserir chamada". O usuário deve seguir estas etapas:
|
Serviço
Serviço de frete.
Representação JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campos | |
---|---|
deliveryCountries[] |
Obrigatório. O código de território CLDR dos países a que o serviço se aplica. |
rateGroups[] |
Opcional. Definições do grupo de taxas de frete. Apenas o último pode ter um |
loyaltyPrograms[] |
Opcional. Programas de fidelidade a que esse serviço de frete está limitado. |
serviceName |
Obrigatório. Nome em formato livre do serviço. Precisa ser exclusivo na conta de destino. |
active |
Obrigatório. Um booleano que expõe o status ativo do serviço de frete. |
currencyCode |
O código CLDR da moeda a que este serviço se aplica. Precisa corresponder ao preço dos grupos de tarifas. |
deliveryTime |
Obrigatório. Tempo gasto em vários aspectos, desde o pedido até a entrega do produto. |
shipmentType |
Tipo de local para onde o serviço envia pedidos. |
minimumOrderValue |
Valor mínimo do pedido para este serviço. Se definido, indica que os clientes terão que gastar pelo menos esse valor. Todos os preços de um serviço precisam ter a mesma moeda. Não pode ser definido junto com o menoresOrderValueTable. |
minimumOrderValueTable |
Tabela de valores mínimos de pedidos por loja para o tipo de fulfillment de retirada. Não pode ser definido junto com ominimumOrderValue. |
storeConfig |
Uma lista de lojas de onde os produtos são enviados. Válido apenas para o tipo de frete para entrega local. |
DeliveryTime
Tempo gasto em vários aspectos, desde o pedido até a entrega do produto.
Representação JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
Campos | |
---|---|
warehouseBasedDeliveryTimes[] |
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 |
Número mínimo de dias úteis gasto em trânsito. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. Defina |
maxTransitDays |
Número máximo de dias úteis gasto em trânsito. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. Precisa ser maior que ou igual a |
cutoffTime |
Definição do horário limite dos dias úteis. Se ele não for configurado, o horário limite será definido como 8h PST. |
minHandlingDays |
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 |
O número máximo de dias úteis é gasto antes do envio de um pedido. 0 significa enviado no mesmo dia, 1 significa enviado no dia seguinte. Precisa ser maior ou igual a |
transitTimeTable |
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 |
handlingBusinessDayConfig |
Os dias úteis durante os quais os pedidos podem ser processados. Se não for informado, serão considerados dias úteis de segunda a sexta-feira. |
transitBusinessDayConfig |
Os dias úteis durante os quais 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 |
Obrigatório. Hora do horário limite até que um pedido seja feito para ser processado no mesmo dia. |
minute |
Obrigatório. Minuto do horário limite até o momento em que um pedido precisa ser feito para ser processado no mesmo dia. |
timeZone |
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 ( |
Campos | |
---|---|
postalCodeGroupNames[] |
Obrigatório. Uma lista de nomes de regiões |
transitTimeLabels[] |
Obrigatório. Uma lista de rótulos de tempo em trânsito. O último valor pode ser |
rows[] |
Obrigatório. Se houver apenas um conjunto de dimensões de |
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 ( |
Campos | |
---|---|
values[] |
Obrigatório. Intervalo de tempo em trânsito (mín.-máx.) em dias úteis. |
TransitTimeValue
Intervalo de tempo em trânsito (mín.-máx.) em dias úteis.
Representação JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
Campos | |
---|---|
minTransitDays |
Período mínimo de trânsito em dias úteis. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. |
maxTransitDays |
Precisa ser maior que ou igual a |
BusinessDayConfig
Dias úteis do armazém.
Representação JSON |
---|
{
"businessDays": [
enum ( |
Campos | |
---|---|
businessDays[] |
Obrigatório. Dias úteis normais. Não pode ficar em branco. |
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 |
Obrigatório. Operadora, como |
carrierService |
Obrigatório. Serviço da operadora, como |
warehouse |
Obrigatório. Nome do warehouse. Ele deve 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". Os outros applicableShippingLabels
não podem se sobrepor.
Representação JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Campos | |
---|---|
applicableShippingLabels[] |
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[] |
Opcional. Uma lista de subtabelas referenciadas por |
carrierRates[] |
Opcional. Uma lista de taxas de transportadoras que podem ser indicadas por |
singleValue |
O valor do grupo de taxas (por exemplo, taxa fixa de US $10). Só poderá ser definido se |
mainTable |
Uma tabela que define o grupo de tarifas, quando |
name |
Opcional. Nome do grupo de taxas. Se definido, 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 ( |
Campos | |
---|---|
noShipping |
Se verdadeiro, o produto não pode ser enviado. Precisa ser "true" quando definido. Só poderá ser definido se todos os outros campos não estiverem definidos. |
flatRate |
Uma taxa fixa. Só poderá ser definido se todos os outros campos não estiverem definidos. |
pricePercentage |
Uma porcentagem do preço representada como um número em notação decimal (por exemplo, |
carrierRate |
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 |
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 ( |
Campos | |
---|---|
rows[] |
Obrigatório. A lista de linhas que constituem a tabela. Precisa ter o mesmo comprimento de |
name |
Nome da tabela. Obrigatório para subtabelas, ignorado para a tabela principal. |
rowHeaders |
Obrigatório. Cabeçalhos das linhas da tabela. |
columnHeaders |
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 para uma tabela. Exatamente um de prices
, weights
, num_items
, postalCodeGroupNames
ou location
precisa ser definido.
Representação JSON |
---|
{ "prices": [ { object ( |
Campos | |
---|---|
prices[] |
Obrigatório. Uma lista de limites superiores para preços de pedidos inclusivos. O valor do último preço pode ser infinito, definindo preço amountMicros = -1. Por exemplo, |
weights[] |
Obrigatório. Uma lista de limites superiores de ponderação de ordem inclusiva. O valor do último peso pode ser infinito definindo price amountMicros = -1. Por exemplo, |
numberOfItems[] |
Obrigatório. Uma lista de número de limites superiores de itens inclusivos. O último valor pode ser |
postalCodeGroupNames[] |
Obrigatório. Uma lista de nomes de grupos postais. O último valor pode ser |
locations[] |
Obrigatório. Uma lista de conjuntos de IDs de local. Precisa estar preenchido. Só poderá 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 ( |
Campos | |
---|---|
unit |
Obrigatório. A unidade de peso. Os valores aceitáveis são: kg e lb |
amountMicros |
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-se como -1. Este campo só é compatível com -1 e valor positivo. |
WeightUnit
A unidade de peso.
Enums | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unidade não especificada |
POUND |
unidade de lb |
KILOGRAM |
kg unidade. |
LocationIdSet
Uma lista de conjuntos de IDs de local. Não pode ficar em branco. Só pode ser definido se todos os outros campos não estiverem definidos.
Representação JSON |
---|
{ "locationIds": [ string ] } |
Campos | |
---|---|
locationIds[] |
Obrigatório. Uma lista não vazia de IDs de local. Todos eles precisam ser do mesmo tipo de local (por exemplo, estado). |
Row
Inclua uma lista de células.
Representação JSON |
---|
{
"cells": [
{
object ( |
Campos | |
---|---|
cells[] |
Obrigatório. A lista de células que constituem a linha. Precisa ter o mesmo comprimento de |
CarrierRate
Uma lista de taxas de transportadoras que podem ser indicadas por mainTable
ou singleValue
.
Representação JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
Campos | |
---|---|
name |
Obrigatório. Nome da tarifa da operadora. Precisa ser exclusivo por grupo de taxas. |
carrier |
Obrigatório. Serviço de operadora, como |
carrierService |
Obrigatório. Serviço de operadora, como |
originPostalCode |
Obrigatório. Origem do envio para esta taxa da transportadora. |
percentageAdjustment |
Opcional. Modificador multiplicador da taxa de frete como um número em notação decimal. Pode ser negativo. Por exemplo, |
flatAdjustment |
Opcional. Modificador aditivo da taxa de frete. Pode ser negativo. Por exemplo, |
ShipmentType
Tipo de envio do serviço de frete.
Enums | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Este serviço não especificou o tipo de envio. |
DELIVERY |
Este serviço envia os pedidos para um endereço escolhido pelo cliente. |
LOCAL_DELIVERY |
Este serviço envia os pedidos para um endereço escolhido pelo cliente. O pedido é enviado de uma loja próxima. |
COLLECTION_POINT |
Esse serviço envia pedidos para um endereço escolhido pelo cliente. O pedido é enviado de um local de coleta. |
MinimumOrderValueTable
Tabela de valores mínimos de pedidos por loja para o tipo de fulfillment de retirada.
Representação JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
Campos | |
---|---|
storeCodeSetWithMovs[] |
Obrigatório. Uma lista de conjuntos de códigos de loja que compartilham o mesmo valor mínimo do pedido (MOV, na sigla em inglês). 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 pode aparecer apenas 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 ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Uma lista de códigos de loja exclusivos ou vazia para "pega-tudo". |
value |
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 ( |
Campos | |
---|---|
storeCodes[] |
Opcional. Uma lista de códigos de loja que oferecem entrega local. Se estiver vazio, |
storeServiceType |
Indica se todas as lojas ou lojas selecionadas listadas pelo comerciante oferecem entrega local. |
cutoffConfig |
As configurações relacionadas à entrega local são encerradas para o dia. |
serviceRadius |
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 por esse 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 terminam no dia.
Representação JSON |
---|
{
"localCutoffTime": {
object ( |
Campos | |
---|---|
localCutoffTime |
Hora em que a entrega local termina no dia. |
storeCloseOffsetHours |
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 |
noDeliveryPostCutoff |
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 já tiver passado do limite, definir esse campo como |
LocalCutoffTime
Hora em que a entrega local termina no dia.
Representação JSON |
---|
{ "hour": string, "minute": string } |
Campos | |
---|---|
hour |
Os pedidos de entrega local em uma hora precisam ser feitos até esse horário para serem processados no mesmo dia. |
minute |
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 ( |
Campos | |
---|---|
value |
Valor inteiro da distância. |
unit |
A unidade pode diferir com base no país. Ela é parametrizada para incluir milhas e quilômetros. |
Unidade
A unidade pode diferir com base no país. Ela é 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 ( |
Campos | |
---|---|
loyaltyProgramTiers[] |
Opcional. Nível do programa de fidelidade deste serviço de frete. |
programLabel |
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 de comerciantes.
Representação JSON |
---|
{ "tierLabel": string } |
Campos | |
---|---|
tierLabel |
O subatributo rótulo de 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 armazém de atendimento de pedidos, que armazena e administra o estoque. Próxima tag: 7
Representação JSON |
---|
{ "name": string, "shippingAddress": { object ( |
Campos | |
---|---|
name |
Obrigatório. O nome do warehouse. Precisa ser exclusivo na conta. |
shippingAddress |
Obrigatório. Endereço de entrega do depósito. |
cutoffTime |
Obrigatório. A última hora do dia para aceitar e iniciar o processamento de um pedido. Pedidos posteriores serão processados no dia seguinte. O tempo é baseado no código postal do depósito. |
handlingDays |
Obrigatório. O número de dias que o depósito leva para embalar e enviar um item. Ele está no nível do armazém, mas pode ser substituído no nível da oferta com base nos atributos de um item. |
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 |
Parte do endereço no nível da rua. Por exemplo, |
city |
Obrigatório. Cidade, município ou comuna. Também pode incluir localidades ou sublocalidades dependentes (por exemplo, bairros ou subúrbios). |
administrativeArea |
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 |
Obrigatório. CEP ou código postal (por exemplo, "94043"). |
regionCode |
Obrigatório. Código do país do 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. 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 |
Obrigatório. Horário limite para que um pedido seja feito para ser processado no mesmo dia pelo depósito. O horário é baseado no fuso horário do armazém. |
minute |
Obrigatório. Minuto do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia pelo armazém. O minuto é baseado no fuso horário do depósito. |