Esta página foi traduzida pela API Cloud Translation.

Visão geral das configurações de frete

A ShippingSettings permite que você recupere e atualize as configurações de frete da sua conta.

O Google pode atualizar automaticamente o tempo de entrega estimado de alguns produtos. Para mais informações, consulte Ativar e melhorias de desempenho.

Ler, gravar ou atualizar as configurações de frete

Para usar o serviço de frete da API Merchant, faça o seguinte:

Faça uma solicitação GET para recuperar as configurações completas de frete do seu do Compute Engine.
Modifique as configurações de frete.
Faça uma solicitação INSERT com as configurações de frete modificadas.

ETag

A ETag é um token codificado para evitar atualizações assíncronas. A etag muda quando qualquer mudança nos dados das configurações de frete. Os usuários precisam copiar a ETag da solicitação GET para o corpo da solicitação INSERT.

Se os dados das configurações de frete mudarem entre a solicitação GET e a INSERT solicitação, você recebe uma mensagem de erro solicitando outra solicitação GET para recuperar o token etag mais recente. Você precisa chamar a solicitação GET para recupere o novo token etag e copie-o para a solicitação INSERT corpo

Adicione suas configurações de frete

Use shippingsettings.insert para adicionar ou atualizar as configurações de frete da sua do Compute Engine. Confira um exemplo de solicitação que atualiza a maxTransitDays para 7 em um Serviço de frete chamado GSA Frete – Frete grátis acima de US $49,99, na conta 10.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

Definir warehouses

O exemplo de JSON a seguir mostra como usar as configurações de frete do comerciante para gerenciar informações do armazém da sua conta de comerciante:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

Substitua:

{street_address}: parte da rua do endereço do armazém.
{city}: cidade ou município onde o armazém está localizado.
{administrative_area}: a subdivisão administrativa da país. Por exemplo, um estado.
{postal_code}: o código postal ou CEP.
{region_code}: o código do país na string.
{minutes}: minutos que fazem parte do horário limite até o qual uma o pedido deve ser feito para ser processado no mesmo dia pelo armazém.
{handling_days}: o número de dias necessários para em um armazém para embalar e enviar um item.

O recurso warehouses é uma lista de warehouses. Cada warehouse pode ser indicado pelo tempo de entrega baseado no armazém do serviço de frete por meio do warehouse.name:

Gerenciar seus warehouses

Veja como usar a API Merchant para gerenciar seus depósitos:

Faça uma solicitação GET para recuperar todos os shippingsettings e armazéns.
Copie o shippingsettings da solicitação GET para a solicitação UPDATE.

Observação: se você não copiar todos os shippingsettings atuais, eles serão excluídos da sua conta na solicitação INSERT.
Preencha os warehouses se quiser usá-los na seção warehouses para a solicitação INSERT.
Fazer uma solicitação UPDATE que contenha shippingsettings e warehouses do Google Cloud.

Confira um exemplo de corpo de solicitação INSERT com o warehouse do Warehouse 1 atualizado de Nova York a Mountain View:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

Adicionar entrega no mesmo dia

Você pode usar a API Content for Shopping para configurar o frete para entrega no mesmo dia serviços se você tiver um inventário local. Os serviços de entrega no mesmo dia têm local_delivery como shipment_type. Todos os fretes de local_delivery serviços são consideradas entregas no mesmo dia.

Não é possível mudar as informações de delivery_time para entregas locais. Usar shippingsettings.insert para configurar a entrega no mesmo dia para seu inventário local produtos.

Veja um exemplo de corpo de solicitação que adiciona um serviço de entrega no mesmo dia a todas as lojas para sua conta:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

Adicionar entrega no dia seguinte

Os pedidos feitos após o horário limite para entrega no mesmo dia estão programados para a próxima por padrão. Para desativar a entrega no dia seguinte, defina o no_delivery_post_cutoff como verdadeiro. Se você desativar a entrega no dia seguinte, seu os serviços de frete só ficam visíveis antes do horário limite todos os dias.

A entrega no dia seguinte só vai estar disponível se o shipment_type estiver local_delivery.

Saiba mais

Para saber mais sobre a migração da API Content for Shopping, consulte Migrar frete de configuração do Terraform.