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:
- Os usuários da API do comerciante precisam colocar
accounts/{accountId}/shippingSettings
no campo {name} para ter o mesmo comportamento. - 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.
- 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 emshippingsettings.warehouses
. Em seguida, cada serviço de frete pode referenciar o armazém pelo nome do armazém emwarehouseBaseDeliveryTime
. - 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:
- Armazenamentos: fornece informações sobre um armazém de fulfillment, que armazena e gerencia o inventário.
- Programas de fidelidade: os usuários da API Merchant podem inserir as informações do programa de fidelidade nas configurações de frete.
- 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
| MétodosConfira uma comparação dos métodos na API Content for Shopping e na API Merchant Shipping Settings:
|