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

O recurso ShippingSettings permite recuperar e atualizar as configurações de frete da sua conta e de todas as subcontas associadas a ela. Para mais informações sobre como adicionar ou gerenciar as configurações de frete da sua conta, consulte Visão geral das configurações de frete.

Para usar a API Merchant e ler as informações das configurações de frete, use as seguintes solicitações:

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

Substitua {ACCOUNT_ID} pelo identificador exclusivo da sua conta do Merchant Center.

Para usar a API Merchant e atualizar as informações das configurações de frete, use as seguintes solicitações:

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

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

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

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

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

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

1. Os usuários da API Merchant precisam colocar accounts/{ACCOUNT_ID}/shippingSettings no campo {NAME} para ter o mesmo comportamento.
2. A API Merchant não oferece suporte a operações de leitura e gravação em áreas personalizadas, como grupos de locais. As áreas personalizadas, como grupos de locais, só podem ser lidas ou gravadas usando o serviço de região.
3. A maneira de configurar WarehouseBasedDeliveryTime é diferente na API Merchant em comparação com a API Content for Shopping. Se você estiver usando a API Merchant, defina as informações do depósito em shippingsettings.warehouses. Em seguida, cada serviço de frete pode fazer referência ao armazém pelo nome em warehouseBaseDeliveryTime.
4. Um serviço na API Merchant oferece suporte a vários países de entrega.

Novos campos aceitos

A API Merchant Shipping Settings oferece suporte aos seguintes novos campos em comparação com a API Content for Shopping:

1. Armazéns: fornece informações sobre um centro de atendimento, que armazena e processa o inventário.
2. Programas de fidelidade: os usuários da API Merchant podem inserir informações do programa de fidelidade nas configurações de frete.
3. Etag: o Etag foi criado para resolver problemas assíncronos quando diferentes usuários tentam atualizar as configurações de frete usando a API Merchant e a interface do Merchant Center 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 do serviço em formato livre 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 fica 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 fica 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	Número máximo de dias úteis gastos 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 tarifas da operadora.
service.minimumOrderValueTable.storeCodeSetWithMovs	services.minimumOrderValueTable.storeCodeSetWithMovs	Uma lista de conjuntos de códigos de 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 campos a seguir da API Content foram descontinuados na API Merchant. A API Merchant não oferece 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

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

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