Serviço de inventário local

O serviço de inventário local permite criar e atualizar instâncias do recurso de inventário local, que contém campos com valores diferentes para diferentes locais de lojas físicas. Cada instância de inventário disponível na loja física é um filho de um recurso de produto e herda os campos de dados do recurso pai. Por exemplo, um produto pode ter um preço e uma quantidade diferentes em lojas diferentes, mas compartilhar um ID, uma descrição e outros dados em todas elas. Os dados de inventário local são usados nos programas Google plataformas local 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 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: Plataformas locais no Google 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 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, crie produtos locais usando o serviço products da API Content ou os feeds de dados do Merchant Center, definindo o campo channel como local. Em seguida, use o serviço de inventário local para criar instâncias de inventário local para cada Perfil da Empresa storecode em que o produto é vendido.

Campos

Cada instância de inventário local contém um conjunto de campos associados a um local específico da loja 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 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 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 essa 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.