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

Use a API Merchant para ler informações das configurações de frete usando as seguintes solicitações:

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

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

Use a API Merchant para ler informações das configurações de frete usando as seguintes solicitações:

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

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

Confira uma comparação entre a API Content for Shopping e a API Merchant Shipping Settings:

	API Content	API do comerciante
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 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 do comerciante precisam colocar accounts/{accountId}/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 por locais. Á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 para a API Merchant em comparação com a API Content for Shopping. Se você estiver usando a API Merchant, defina as informações do armazenamento em shippingsettings.warehouses. Em seguida, cada serviço de frete pode referenciar o armazém pelo nome do armazém em warehouseBaseDeliveryTime.
4. Um serviço na API Merchant Center aceita vários países de entrega.

Novos campos compatíveis

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

1. Armazenamentos: fornece informações sobre um armazém de fulfillment, que armazena e gerencia o inventário.
2. Programas de fidelidade: os usuários da API Merchant podem inserir as informações do programa de fidelidade nas configurações de frete.
3. Etag: foi criada para resolver problemas assíncronos quando diferentes usuários tentam atualizar as configurações de frete usando a API 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 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 pode ficar 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 pode ficar em trânsito.
service.deliveryTime.minHandlingTimeInDays	services.deliveryTime.minHandlingDays	Número mínimo de dias úteis gastos antes de um pedido ser enviado.
service.deliveryTime.maxHandlingTimeInDays	services.deliveryTime.maxHandlingDays	Número máximo de dias úteis decorridos antes do envio de um pedido.
service.deliveryTime.cutoffTime.timezone	services.deliveryTime.cutoffTime.timeZone	Identificador de fuso horário do 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 campos a seguir foram descontinuados na API Merchant. A API Merchant não fornece alternativas para esses campos.

API Content for Shopping	API do comerciante
postal_code_group	region
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 |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 Settings: Método API Content for Shopping API do comerciante customBatch Sim Não get Sim Sim update Sim Não inserir Não Sim getSupportedCarrier Sim Não getSupportedHolidays Sim Não