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

O ShippingSettings recurso 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 você pode 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 informações sobre as configurações de frete, use as seguintes solicitações:

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

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

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

POST https://merchantapi.googleapis.com/accounts/v1/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 o recurso de configurações de frete na sub-API Accounts:

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

A lista a seguir menciona as principais atualizações no recurso de configurações de frete na sub-API Accounts em comparação com a API Content for Shopping:

  1. Os usuários da API Merchant precisam inserir 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 por locais. Áreas personalizadas, como grupos por locais, só podem ser lidas ou gravadas usando o serviço de região.
  3. Um serviço na API Merchant oferece suporte a vários países de entrega.
  4. A API Merchant não oferece um método de lista para configurações de frete, ao contrário do método shippingsettings.list na API Content.

Novos campos aceitos

O recurso de configurações de frete na sub-API Accounts oferece suporte aos seguintes novos campos em comparação com a API Content for Shopping:

  1. warehouses: fornece informações sobre um armazém de processamento de pedidos, que armazena e processa o inventário.
  2. Programas de fidelidade: os usuários da API Merchant podem inserir informações sobre programas de fidelidade nas configurações de frete.
  3. Etag: Etag foi projetado 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 no recurso de configurações de frete na sub-API Accounts:

API Content for Shopping Recurso de configurações de frete Descrição
service services Um único serviço de frete.
service.name services.serviceName Nome de 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 esse serviço se aplica.
service.deliveryTime.minTransitTimeInDays services.deliveryTime.minTransitDays Número mínimo de dias úteis que um pedido passa 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 passa 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 de 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 transportadora.
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 removidos

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 removidos

Os seguintes campos da API Content for Shopping foram removidos 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

    • Rate_group
      • single_value_alternative_list

Métodos

Confira uma comparação dos métodos na API Content for Shopping e no recurso de configurações de frete:

Método API Content for Shopping API Merchant
customBatch Sim Não
get Sim Sim
update Sim Não
insert Não Sim
list Sim Não
getSupportedCarrier Sim Não
getSupportedHolidays Sim Não
Anterior
Migrate data sources management
Avançar
Migrate conversion sources management