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, 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.

Observação :na v2.1 da API Content, o serviço de inventário local e os feeds complementares substituem o serviço de inventário da v2. Para realizar atualizações parciais em dados de produtos não locais com a API v2.1, use feeds complementares. Para fazer atualizações complementares de produtos disponíveis na loja física, use o serviço localinventory.

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.

  Observação: se a conta do Merchant Center não estiver inscrita em um programa local, definir o campo channel de um produto como local pelo método Products.insert resultará no erro: "channel Canal inválido: 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 como local. É possível usar o serviço de inventário local para criar instâncias desse tipo 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 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.

Observação: não é possível recuperar, listar ou excluir instâncias de inventário local. Para visualizar os dados de inventário local no Merchant Center, selecione um produto disponível na loja física na página Todos os produtos e expanda a seção Inventário local. A tabela exibe os dados de inventário local para cada código da loja.