- 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](https://support.google.com/merchants/answer/6069284) 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 warehouses 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. Somente o último pode ter um |
loyaltyPrograms[] |
Opcional. Programas de fidelidade a que este 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 do pedido até a entrega do produto. |
shipmentType |
Tipo de locais para onde este 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 comminimumOrderValueTable. |
minimumOrderValueTable |
Tabela de valores mínimos de pedido por loja para o tipo de processamento do pedido para retirada. Não pode ser definido junto com ominimumOrderValue. |
storeConfig |
Uma lista de lojas de onde seus produtos são entregues. Válido apenas para o tipo de frete para entrega local. |
DeliveryTime
Tempo gasto em vários aspectos do 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 em 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, 1 significa entrega no dia seguinte. Defina |
maxTransitDays |
Número máximo de dias úteis gastos em trânsito. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. Precisa ser maior ou igual a |
cutoffTime |
Definição do horário limite para 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 enviado no mesmo dia, 1 significa enviado no dia seguinte. |
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 em 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 for informado, serão considerados dias úteis de segunda a sexta-feira. |
CutoffTime
Definição do horário limite para 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, "Europa/Zurique". |
TransitTable
Tabela de tempo em 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 corresponderá a um 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 |
Intervalo de tempo mínimo em trânsito em dias úteis. 0 significa entrega no mesmo dia, 1 significa entrega no dia seguinte. |
maxTransitDays |
Precisa ser maior 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 em trânsito no deliveryTime
precisa 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. Somente o último pode ter um applicableShippingLabels
vazio, o que significa "todo o restante". 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 definem os produtos aos quais esse grupo de taxas se aplica. Isso é uma disjunção: apenas um dos rótulos precisa corresponder para que o grupo de taxas seja aplicado. Pode estar em branco somente 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 taxas, 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 taxas ou o valor da célula de uma tabela do grupo de taxas. Exatamente um de noShipping
, flatRate
, pricePercentage
, carrier_rateName
ou subtable_name
precisa ser definido.
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 taxa de transportadora que se refere a uma taxa da transportadora definida no mesmo grupo de taxas. Só poderá ser definido se todos os outros campos não estiverem definidos. |
subtable |
O nome de uma subtabela. Só pode ser definido em células da 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 taxas, 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 que |
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 ela não for definida, 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 preço amountMicros = -1. Por exemplo, |
numberOfItems[] |
Obrigatório. Uma lista de números inclusivos de limites superiores de itens. 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. Não pode ficar em branco. Só poderá ser definido se todos os outros campos não estiverem definidos. |
Peso
O peso representado como o valor na 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 é o equivalente à unidade padrão de moeda de uma pessoa, por exemplo, 1 kg = 1000000 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ó poderá 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 locais. Todos eles precisam ser do mesmo tipo de local (por exemplo, estado). |
Linha
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 que |
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 taxa da transportadora. Precisa ser exclusivo por grupo de taxas. |
carrier |
Obrigatório. Serviço da operadora, como |
carrierService |
Obrigatório. Serviço da operadora, como |
originPostalCode |
Obrigatório. Origem do envio para esta taxa da transportadora. |
percentageAdjustment |
Opcional. Modificador de taxa de frete multiplicativa como um número em notação decimal. Pode ser negativo. Por exemplo, |
flatAdjustment |
Opcional. Modificador aditivo de 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 remessa. |
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 |
Este serviço envia os pedidos para um endereço escolhido pelo cliente. O pedido é enviado de um local de coleta. |
MinimumOrderValueTable
Tabela de valores mínimos de pedido por loja para o tipo de processamento do pedido para 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). São necessários pelo menos dois conjuntos, 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 de um serviço precisam ter a mesma moeda. |
StoreCodeSetWithMov
Uma lista de conjuntos de códigos da loja que compartilham o mesmo valor mínimo do pedido. São necessários pelo menos dois conjuntos, e o último precisa estar vazio, o que significa "MOV para todas as outras lojas". Cada código de loja só pode aparecer uma vez em todos os conjuntos. Todos os preços de 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 das lojas indicadas. |
StoreConfig
Uma lista de lojas de onde seus produtos são entregues. Válido apenas para o tipo de frete para 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 por esse comerciante oferecem entrega local. |
cutoffConfig |
As configurações relacionadas à entrega local terminam no dia. |
serviceRadius |
Raio máximo de entrega. Isso é necessário apenas para o tipo de frete para entrega local. |
StoreServiceType
Indica se todas as lojas ou lojas selecionadas listadas pelo comerciante oferecem entrega local.
Enums | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
O tipo de serviço da loja não foi especificado. |
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 |
Horário em que a entrega local do dia termina. |
storeCloseOffsetHours |
Válido apenas com processamento do pedido de entrega local. O horário limite é representado pelo número de horas antes do fechamento da loja. Mutuamente exclusivo com |
noDeliveryPostCutoff |
Os comerciantes podem desativar a exibição da entrega local de n + 1 dia se tiverem um serviço de frete configurado para a entrega local com 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
Horário em que a entrega local do dia termina.
Representação JSON |
---|
{ "hour": string, "minute": string } |
Campos | |
---|---|
hour |
Os pedidos de entrega local por hora precisam ser feitos para que o processamento seja feito no mesmo dia. |
minute |
Os pedidos de entrega local em minutos precisam ser feitos por para serem processados no mesmo dia. |
Distância
Raio máximo de entrega. Isso é necessário apenas para o tipo de frete para 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 do programa no Merchant Center. Com esse subatributo, o Google pode mapear seu 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 horário é baseado no CEP do armazém. |
handlingDays |
Obrigatório. O número de dias que leva para este depósito 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 definida, o padrão será de segunda a sexta-feira. |
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. Código postal ou CEP (por exemplo, "94043"). |
regionCode |
Obrigatório. Código do país do CLDR (por exemplo, "US"). |
WarehouseCutoffTime
A última hora do dia para aceitar e iniciar o processamento de um pedido. Pedidos posteriores serão processados no dia seguinte. O horário é baseado no CEP do armazém.
Representação JSON |
---|
{ "hour": integer, "minute": integer } |
Campos | |
---|---|
hour |
Obrigatório. Hora do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia pelo armazém. 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 armazém. |