Migrar o gerenciamento de inventário da API Content for Shopping

É possível usar a API Merchant para gerenciar o inventário local (na loja) e regional.

Solicitações

Use o seguinte formato de URL de solicitação para a sub-API Inventories:

POST https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/regionalInventories

Na API Merchant, a sub-API Inventories e o endpoint relacionado são chamados de "inventories" no plural.

Confira um exemplo de comparação entre a API Content for Shopping e a API Merchant Inventories para solicitações de inventário local:

API Content API Merchant
URL https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}/localinventory https://merchantapi.googleapis.com/inventories/v1beta/{PARENT}/localInventories
Identificadores {MERCHANT_ID}/products/{PRODUCT_ID} {NAME}

Métodos

A API Merchant apresenta dois novos métodos para gerenciamento de inventário:

  • Listar os inventários locais e regionais dos seus produtos
  • Remover o inventário local e regional dos seus produtos

Confira uma comparação dos métodos de inventários na API Content for Shopping e na API Merchant Inventories:

Método API Content for Shopping API Merchant
customBatch Sim Não
insert Sim Sim
list Não Sim
delete Não Sim

Inventário local

Confira o que mudou para o inventário local na API Merchant Inventories:

API Content for Shopping API Merchant Descrição
Sem suporte name:string Foi adicionado um novo campo para diferenciar os recursos LocalInventory em um product. A API Content for Shopping identifica o inventário local por storeCode e productId.
Sem suporte account:string Novo campo adicionado para identificar a conta do comerciante a que product e LocalInventory pertencem.
price: {

object (Price)

}

price: {

object (Price)

}

A definição de Price foi alterada.
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

A definição de Price foi alterada.
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate usa o novo tipo TimePeriod na API Merchant Inventories.
quantity:string, quantity:integer quantity usa um número inteiro em vez de uma string na API Merchant Inventories.
kind:string Sem suporte kind não é compatível com a API Merchant Inventories.
Sem suporte localShippingLabel:string Novo campo adicionado para rotular serviços de frete locais na API Merchant Inventories.

Inventário regional

Confira o que mudou para o inventário regional na API Merchant Inventories:

API Content for Shopping API Merchant Descrição
Sem suporte name:string Foi adicionado um novo campo para diferenciar os recursos regionalInventory em um product. A API Content for Shopping identifica o inventário regional por regionId e productId.
Sem suporte account:string Novo campo adicionado para identificar a conta do comerciante a que product e regionalInventory pertencem.
"regionId": string "region": string regionID é chamado de region na API Merchant Inventories.
price: {

object (Price)

}

price: {

object (Price)

}

A definição de Price foi alterada.
salePrice: {

object (Price)

}

salePrice: {

object (Price)

}

A definição de Price foi alterada.
salePriceEffectiveDate: string salePriceEffectiveDate: {

object (TimePeriod)

},

salePriceEffectiveDate usa o novo tipo TimePeriod na API Merchant Inventories.
kind:string Sem suporte Não há suporte para kind na API Merchant Inventories.