Migrar as configurações de frete da API Content for Shopping

A ShippingSettings você pode recuperar e atualizar as configurações de frete da sua conta e todas as subcontas associadas a ele. Para mais informações sobre como adicionar ou gerenciar as configurações de frete da conta. Consulte Visão geral do frete padrão.

Se quiser usar a API Merchant para ler as informações das configurações de frete, faça o seguinte: solicitações:

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

Substitua {accountId} pelo identificador exclusivo do seu na sua conta do Merchant Center.

Se quiser usar a API Merchant para ler as informações das configurações de frete, faça o seguinte: solicitações:

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

Para mais informações, consulte Método: accounts.shippingSettings.insert.

Comparação entre a API Content for Shopping e a API Merchant

Este é um exemplo de comparação entre a API Content for Shopping e a API Merchant API Shipping Settings:

	API Content	API Merchant
URL	https://shoppingcontent.googleapis.com/content/v2.1/{accountId}/shippingsettings:insert	https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings:insert
Identificadores	{accountId}/shippingsettings/{accountId}	{name}

A lista a seguir mostra as principais atualizações da API Merchant Shipping Settings em comparação com a API Content for Shopping:

1. Os usuários da API Merchant devem colocar accounts/{accountId}/shippingSettings no {name} para ter o mesmo comportamento.
2. A API Merchant não suporta operações de leitura e gravação em áreas personalizadas, como como grupos por locais. Áreas personalizadas, como grupos por locais, só podem ser de leitura ou gravados usando o serviço de região.
3. Como configurar o WarehouseBasedDeliveryTime é diferente para a API Merchant em relação à API Content for Shopping. Se você estiver usando a API Merchant, defina as informações do armazém em shippingsettings.warehouses: Depois, cada serviço de frete pode fazer referência ao warehouse por nome do warehouse em warehouseBaseDeliveryTime.
4. Um serviço na API Merchant API é compatível com vários países de entrega.

Novos campos compatíveis

A API Merchant Shipping Settings é compatível com os novos campos a seguir em comparação com API Content for Shopping:

1. Armazéns: disponibiliza informações sobre um armazém de atendimento de pedidos. que armazena e manuseia o inventário.
2. Programas de fidelidade: os usuários da API Merchant podem inserir informações do programa de fidelidade em as configurações de frete.
3. Etag: a Etag foi desenvolvida para resolver problemas assíncronos quando diferentes usuários tentam atualize as configurações de frete usando a API Merchant Center e a interface do Merchant Center na ao mesmo tempo.

Campos renomeados

Os seguintes campos foram renomeados na API Merchant:

API Content for Shopping	API Merchant Shipping Settings	Descrição
service	services	Um único serviço de frete.
service.name	services.serviceName	Nome em formato livre do serviço que precisa ser exclusivo na sua conta do Merchant Center.
service.deliveryCountry	services.deliveryCountries	O código de território CLDR do país a que o serviço de frete se aplica.
service.currency	services.currencyCode	O código CLDR da moeda a que este serviço se aplica.
service.deliveryTime.minTransitTimeInDays	services.deliveryTime.minTransitDays	Número mínimo de dias úteis que um pedido gasta em trânsito. Por exemplo, 0 significa entrega no mesmo dia e 1 significa entrega no dia seguinte.
service.deliveryTime.maxTransitTimeInDays	services.deliveryTime.maxTransitDays	Número máximo de dias úteis que um pedido gasta em trânsito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Número mínimo de dias úteis gastos antes do envio de um pedido.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	O número máximo de dias úteis é gasto antes do envio de um pedido.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identificador de fuso horário para o horário limite.
service.deliveryTime.transitTimeTable.postalCodeGroupName	services.deliveryTime.transitTimeTable.postalCodeGroupNames	O nome do grupo de códigos postais.
service.deliveryTime.transitTimeTable.transitTimeLabel	services.deliveryTime.transitTimeTable.transitTimeLabel	O rótulo de tempo em trânsito do produto.
service.rate_group	services.rateGroups	Definições do grupo de taxas de frete.
service.rate_group.subtable	services.rateGroups.subtables	Uma lista de subtabelas.
service.rate_group.carrier_rate	services.rateGroups.carrierRates	Uma lista de taxas de transportadoras.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Uma lista de conjuntos de códigos da loja que compartilham o mesmo valor mínimo do pedido.

Métodos obsoletos

Não é possível usar shippingsettings.custombatch para recuperar e atualizar as configurações de frete de várias contas em uma única solicitação;

Campos descontinuados

Os seguintes campos da API Content foram descontinuados na API Merchant. Comerciante A API não fornece nenhuma alternativa para esses campos.

• postal_code_group
• service
• Pickup_service
• Eligibility
• Scheduling_channel
• Delivery_time
• Holiday_cutoff
• Min_scheduling_time_in_days
• Max_scheduling_time_in_days
• Scheduling_business_day_config
• Rate_group
  • single_value_alternative_list

Métodos

Esta é uma comparação dos métodos na API Content for Shopping e na API Merchant Shipping Settings:

Método	API Content for Shopping	API Merchant
customBatch	Sim	Não
get	Sim	Sim
update	Sim	Não
insert	Não	Sim
getSupportedCarrier	Sim	Não
getSupportedHolidays	Sim	Não