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 é uma de um recurso de produto existente, e herda os campos de dados do produto das recurso pai. Por exemplo, você pode ter um produto que tem preço e quantidade em diferentes lojas, mas compartilha um ID, uma descrição e outros os dados do produto em todas as lojas. Os dados de inventário local são usados Plataformas locais no Google e os anúncios de inventário local programas.

Neste guia, explicamos do que você precisa antes de começar a usar o inventário local. serviço, 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, você precisa: criar um Perfil da Empresa, vincular o Perfil da Empresa à conta do Merchant Center; verificar sua empresa configure 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 Comece a usar os anúncios de inventário local.

  • O serviço de inventário local cria instâncias de inventário local para produtos disponíveis na loja física. Primeiro, você deve criar produtos disponíveis na loja física, usando o menu suspenso serviço de produtos da API ou Os datafeeds do Merchant Center, por definindo o campo channel como local. Depois, você pode usar o inventário local para criar instâncias de inventário local para cada Perfil da Empresa storecode onde o produto é vendido.

Campos

Cada instância de inventário local contém um conjunto de campos associado a um local específico da loja por meio do campo storeCode (que você define em seu 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 uma lista completa dos campos de inventário local e as respectivas descrições, consulte a Referência do localinventory página.

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 usando 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 o inventário local instância. Não gostei feeds complementares Para dados de produtos não locais, os campos que não estiverem incluídos no corpo do 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 você pode criar várias instâncias de inventário local para um único produto disponível na loja física em várias lojas ou criar instâncias de inventário local para vários produtos disponíveis na loja física.