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 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, é possível ter um produto que tem preço e quantidade diferentes em lojas distintas, 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 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 uma solicitação de serviço.

Pré-requisitos

  • Para usar o serviço de inventário local, crie um Perfil da Empresa, vincule-o à sua conta do Merchant Center, verifique sua empresa e configure os códigos de 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 os anúncios de inventário local com a API Content, consulte Primeiros passos com os 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, você precisa criar esses produtos usando o serviço de produtos da API Content ou feeds de dados do Merchant Center, definindo o campo channel como local. É possível usar o serviço de inventário local para criar instâncias desse tipo de inventário para cada storecode 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 loja específica pelo campo storeCode, que você define no Perfil da Empresa. Somente 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 ver uma lista completa dos campos de inventário local e as descrições deles, consulte a página de referência do 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 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 do inventário local. Ao contrário dos feeds complementares para dados de produtos não locais, os campos nã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 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.