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 é uma criança de um recurso de produto existente e herda os campos de dados do produto do recurso pai. Por exemplo, você pode ter um produto com preço e quantidade diferentes em lojas diferentes, mas que compartilha um ID, uma descrição e outros dados do produto em todas as lojas. Os dados de inventário local são usados para os programas Plataformas locais do Google e Anúncios de inventário local.
Este guia explica o que você precisa 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 o Perfil da Empresa à sua conta do Merchant Center, verificar sua empresa e configurar os códigos de loja do Perfil da Empresa.
Sua conta do Merchant Center precisa estar inscrita em um programa local: Plataformas locais no Google ou Anúncios de inventário local. Para mais informações sobre como usar anúncios de inventário local pela API Content, consulte Começar a usar anúncios de inventário local.
O serviço de inventário local cria instâncias de inventário local para produtos locais existentes. Primeiro, é necessário criar produtos locais usando o serviço products da API Content ou os datafeeds do Merchant Center. Para isso, defina o campo
channelcomolocal. Em seguida, use o serviço de inventário local para criar instâncias de inventário local para cada Perfil da Empresastorecodeem que o produto é vendido.
Campos
Cada instância de inventário local contém um conjunto de campos associados a um local de loja específico pelo campo storeCode, que você define no seu 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 uma lista completa de 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 criar uma instância de inventário local para um único produto local.
Este exemplo demonstra como usar o serviço de inventário local para criar uma venda 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
localinventory.custombatch
permite criar várias instâncias de inventário local para um único
produto local em várias lojas ou criar instâncias de inventário local para
vários produtos locais.