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 informações sobre 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 as informações das 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 colocar accounts/{ACCOUNT_ID}/shippingSettings no campo {NAME} para ter o mesmo comportamento.
  2. A API Merchant não é compatível com operações de leitura e gravação em áreas personalizadas, como grupos de 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 é compatível com os seguintes novos campos em comparação com a API Content for Shopping:

  1. warehouses: fornece informações sobre um depósito de atendimento, que armazena e processa o inventário.
  2. Programas de fidelidade: os usuários da API Merchant podem inserir informações de programas de fidelidade nas configurações de frete.
  3. Etag: a Etag foi criada para resolver problemas assíncronos quando usuários diferentes 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 "Configurações de frete" da 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 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 em que o serviço de frete é válido.
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 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 CEPs.
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 taxa 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 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 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 entre os métodos na API Content for Shopping e o 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