- Recurso: ShippingSettings
- Serviço
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Dia da semana
- WarehouseBasedDeliveryTime
- RateGroup
- Valor
- Table
- Cabeçalhos
- Peso
- WeightUnit
- LocationIdSet
- Linha
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distância
- Unidade
- LoyaltyProgram
- LoyaltyProgramTiers
- Armazém
- Endereço
- WarehouseCutoffTime
- Métodos
Recurso: ShippingSettings
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 de configuração de frete não mudaram entre as chamadas de recebimento e inserção. O usuário precisa seguir estas etapas:
|
Serviço
Serviço de frete.
Representação JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
Campos | |
---|---|
delivery |
Obrigatório. O código de território CLDR dos países a que o serviço se aplica. |
rate |
Opcional. Definições do grupo de taxas de frete. Apenas o último pode ter um |
loyalty |
Opcional. Programas de fidelidade a que esse serviço de frete está limitado. |
service |
Obrigatório. Nome do serviço em formato livre. Precisa ser exclusivo na conta de destino. |
active |
Obrigatório. Um booleano que expõe o status ativo do serviço de frete. |
currency |
O código CLDR da moeda a que este serviço se aplica. Precisa corresponder ao dos preços nos grupos de tarifas. |
delivery |
Obrigatório. Tempo gasto em vários aspectos, desde o pedido até a entrega do produto. |
shipment |
Tipo de local para onde o serviço envia pedidos. |
minimum |
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. |
minimum |
Tabela de valores mínimos de pedidos por loja para o tipo de fulfillment de retirada. Não pode ser definido com minimumOrderValue. |
store |
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 ( |
Campos | |
---|---|
warehouse |
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. |
min |
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 |
max |
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 |
cutoff |
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. |
min |
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. |
max |
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 |
transit |
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 |
handling |
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. |
transit |
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 |
Obrigatório. Horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia. |
minute |
Obrigatório. Minuto do horário limite até o qual um pedido precisa ser feito para ser processado no mesmo dia. |
time |
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 | |
---|---|
postal |
Obrigatório. Uma lista de nomes de regiões |
transit |
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. 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 | |
---|---|
min |
Período mínimo de trânsito em dias úteis. 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte. |
max |
Precisa ser maior ou igual a |
BusinessDayConfig
Dias úteis do armazém.
Representação JSON |
---|
{
"businessDays": [
enum ( |
Campos | |
---|---|
business |
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 |
Obrigatório. Operadora, como |
carrier |
Obrigatório. Serviço de operadora, como |
warehouse |
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 ( |
Campos | |
---|---|
applicable |
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 |
carrier |
Opcional. Uma lista de tarifas da operadora que pode ser referenciada por |
single |
O valor do grupo de tarifas (por exemplo, tarifa fixa de US $10). Só pode ser definido se |
main |
Uma tabela que define o grupo de tarifas, quando |
name |
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 ( |
Campos | |
---|---|
no |
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. |
flat |
Uma taxa fixa. Só pode ser definido se todos os outros campos não estiverem definidos. |
price |
Uma porcentagem do preço representada como um número em notação decimal (por exemplo, |
carrier |
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. |
row |
Obrigatório. Cabeçalhos das linhas da tabela. |
column |
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 ( |
Campos | |
---|---|
prices[] |
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, |
weights[] |
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, |
number |
Obrigatório. Uma lista de número de limites superiores de itens inclusivos. O último valor pode ser |
postal |
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ó 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 ( |
Campos | |
---|---|
unit |
Obrigatório. A unidade de peso. Os valores aceitáveis são: kg e lb |
amount |
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 | |
---|---|
location |
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 ( |
Campos | |
---|---|
cells[] |
Obrigatório. A lista de células que constituem a linha. Precisa ter o mesmo comprimento de |
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 ( |
Campos | |
---|---|
name |
Obrigatório. Nome da tarifa da operadora. Precisa ser exclusivo por grupo de tarifas. |
carrier |
Obrigatório. Serviço de operadora, como |
carrier |
Obrigatório. Serviço de operadora, como |
origin |
Obrigatório. Origem do envio para essa tarifa da transportadora. |
percentage |
Opcional. Modificador multiplicativo da taxa de frete como um número em notação decimal. Pode ser negativo. Por exemplo, |
flat |
Opcional. Modificador aditivo da taxa de frete. Pode ser negativo. Por exemplo, |
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 ( |
Campos | |
---|---|
store |
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 ( |
Campos | |
---|---|
store |
Opcional. Uma lista de códigos de loja exclusivos ou vazia para o catch-all. |
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 | |
---|---|
store |
Opcional. Uma lista de códigos de lojas que oferecem entrega local. Se estiver vazio, |
store |
Indica se todas as lojas ou lojas selecionadas listadas pelo comerciante oferecem entrega local. |
cutoff |
As configurações relacionadas à entrega local são encerradas para o dia. |
service |
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 ( |
Campos | |
---|---|
local |
Hora em que a entrega local termina no dia. |
store |
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 |
no |
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 |
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 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 ( |
Campos | |
---|---|
loyalty |
Opcional. Nível do programa de fidelidade deste serviço de frete. |
program |
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 | |
---|---|
tier |
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 ( |
Campos | |
---|---|
name |
Obrigatório. O nome do warehouse. Precisa ser exclusivo na conta. |
shipping |
Obrigatório. Endereço de entrega do depósito. |
cutoff |
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. |
handling |
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. |
business |
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 | |
---|---|
street |
Parte do endereço referente à 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). |
administrative |
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"). |
postal |
Obrigatório. Código postal ou CEP (por exemplo, "94043"). |
region |
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 |
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 |
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 |
|
---|---|
|
Extrair informações das configurações de frete. |
|
Substitua a configuração de frete de um comerciante pela configuração de frete de solicitação. |