O serviço de inventário local permite criar e atualizar instâncias do recurso de inventário local, que contêm campos que podem ter valores diferentes para diferentes locais de lojas físicas. Cada instância de inventário local é filha de um recurso de produto existente e herda os campos de dados do produto do recurso pai. Por exemplo, você pode ter um produto que tem um preço e uma quantidade diferentes em lojas diferentes, mas compartilha um código, uma descrição e outros dados do produto em todas as lojas. Os dados de inventário local são usados nos programas Google plataformas locais e anúncios de inventário local.
Neste guia, explicamos o que você precisa fazer antes de começar a usar o serviço de inventário local, descreve os campos e métodos disponíveis e fornece um exemplo de solicitação de serviço.
Pré-requisitos
- Para usar o serviço de inventário local, você precisa criar um Perfil da Empresa, vincular seu Perfil da Empresa à sua conta do Merchant Center, verificar sua empresa e configurar os códigos da loja do Perfil da Empresa.
Sua conta do Merchant Center precisa estar inscrita em um programa local: Google plataformas locais ou anúncios de inventário local. Para mais informações sobre como usar anúncios de inventário local com a API Content, consulte Introdução aos anúncios de inventário local.
O serviço de inventário local cria instâncias de inventário local para os produtos disponíveis na loja física. Primeiro, crie os produtos disponíveis na loja física usando o serviço de produtos da API Content ou os datafeeds do Merchant Center. Para isso, defina o campo
channel
comolocal
. É possível usar o serviço de inventário local para criar instâncias desse tipo para cadastorecode
do Perfil da Empresa em que o produto é vendido.
Campos
Cada instância de inventário local contém um conjunto de campos associados a uma localização de loja específica pelo campo storeCode
, que você define no Perfil da Empresa. Apenas
storecode
e
productId
são obrigatórios para todas as solicitações. Todos os outros campos são opcionais:
- Obrigatório para todas as solicitações:
storeCode
,productId
(no URL) - Opcional:
quantity
,price
,salePrice
,salePriceEffectiveDate
,availability
,pickupMethod
,pickupSla
,instoreProductLocation
Para conferir uma lista completa dos campos de inventário local e as descrições deles, consulte a página de referência localinventory.
Métodos
O serviço de inventário local inclui apenas dois métodos:
localinventory.insert
localinventory.insert
permite que você crie uma instância de inventário local para um único produto disponível na loja física.
Este exemplo demonstra como usar o serviço de inventário local para criar uma promoção na loja de 24 de fevereiro de 2021 às 13h (GMT-8) até 28 de fevereiro de 2021 às 15h30 (GMT-8). A solicitação também atualiza a quantidade disponível para a instância de inventário local. Ao contrário dos feeds complementares para dados de produtos não locais, os campos que não estão incluídos no corpo da solicitação são substituídos por esta chamada:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory
{
"storeCode": “1235”,
"salePrice": {
"value": “100.00”,
"currency": “USD”
},
"salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
"quantity": 200,
}
localinventory.custombatch
O localinventory.custombatch
permite que você crie várias instâncias de inventário local para um único
produto local em várias lojas ou crie instâncias de inventário local para
vários produtos disponíveis na loja física.