API

---

Autenticação

Para usar uma API do Merchant Center para o Shopping com uma determinada conta do Merchant Center, precisa configurar um projeto no Console de APIs. Ajuda para projetos do console do Google Cloud Você gerencia o acesso à API e a autenticação da sua solução de API do comerciante.

Dependendo do caso de uso, há duas maneiras de acessar a API Merchant:

• Recomendamos usar o OAuth 2.0 para ter acesso a uma conta específica do Merchant Center. por meio de um aplicativo desenvolvido para seus usuários. O usuário vai precisam conceder acesso à sua conta para enviar dados em nome deles.
• Uma conta de serviço é um tipo especial de conta, normalmente usada por um em vez de uma pessoa. Uma conta de serviço é identificada pelo e-mail exclusivo da conta.

Consulte como autenticar usando o OAuth 2.0 ou um serviço padrão.

Dica :ao enviar dados como um provedor de parceria de feed local, o serviço o e-mail da conta precisa ser adicionado à lista de usuários da MCA, já que as chamadas autenticados com essa conta para todas as subcontas da MCA.

Ativar configurações de país

Importante :antes de enviar ofertas, dados necessários para ativar a rede local neste programa.

Chame liasettings.update para especificar os países em que você planeja veicular localmente.

Mais informações sobre a página de segmentação por configurações de país

Enviar dados de ofertas

Há dois tipos de dados: dados do produto e de inventário.

Enviar dados do produto e do inventário de uma só vez

Os dados do produto e do inventário podem ser enviados ao mesmo tempo usando accounts.lfpInventories.insert

O campo "GTIN" funcionará como um identificador de produto para o catálogo do Google, e um feed de produtos será criado automaticamente.

Esse feed criado automaticamente será exibido no Merchant Center de destino como "Provedor de feed local" com as ofertas relevantes associadas.

Esse método funciona bem se todos os produtos do comerciante tiverem um GTIN e nenhum outro serão ativados (como a vitrine local básica hospedada pelo comerciante). Se você planeja ativar a MHLSF para seus comerciantes, envie um feed de produtos dedicado é a configuração recomendada.

O mesmo procedimento pode funcionar com accounts.lfpSales.insert.

Nesse caso, os dados se referem a um evento de venda de um produto específico em uma em um período específico.

Enviar dados do produto e do inventário separadamente

Se os GTINs não estiverem amplamente disponíveis ou se você preferir aproveitar uma feed de produtos na conta de destino do Merchant Center ou ativar a MHLSF para seus comerciantes, você precisa ter um feed de produtos locais específico.

Para ativar essa opção, chame accounts.productInputs.insert. primeiro e inserindo todos os valores estáticos de um produto. Lembre-se de definir Atributo Channel para "local".

Saiba mais sobre os dados básicos do produto neste artigo e sobre a API orientações gerais para inserir produtos.

O fluxo de dados é o seguinte:

• Chame accounts.productInputs.insert primeiro para iniciar o upload produtos para seus comerciantes
• Em seguida, chame accounts.lfpInventories.insert para enviar o inventário. dados.

Como alternativa, os dados de inventário podem ser enviados accounts.lfpSales.insert. Um modelo de machine learning vai prever o preço e a quantidade de ofertas com base nesses dados.

Exemplo de visão geral para accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

Importante: o offerId enviado em accounts.productInputs.insert precisa corresponder ao offerId em accounts.lfpInventories.insert para que as ofertas são mapeadas corretamente.

Importante: accounts.lfpInventories.insert tem um pai no URL. Esta é sua conta de provedor de LFP ativada pelo Equipe de suporte. A conta do Merchant Center do seu varejista está no payload da solicitação em vez disso identificado como TargetMerchant. Este é o ID no Merchant Center do comerciante para enviar o inventário.

Importante :os dados do produto expiram em 30 dias, e os dados de inventário expiram em 14. dias. Isso é eficaz na remoção de produtos indesejados. Produto e inventário os dados podem ser enviados de uma só vez usando accounts.lfpInventories.insert. se os GTINs são conhecidos para todas as ofertas. Como alternativa, use accounts.productInputs.insert para dados de produtos e accounts.lfpInventories.insert (ou accounts.lfpSales.insert) para dados de inventário

Enviar dados do Perfil da Empresa

Quando não for possível acessar a conta do Perfil da Empresa no Google do comerciante para recuperar os códigos de loja, os dados da loja podem ser enviados por accounts.lfpStores.insert pelos seus códigos da loja específicos.

Observe que, ao chamar accounts.lfpinventories.insert ou accounts.lfpSales.insert: o código da loja precisa corresponder ao código da loja. fornecidas nas solicitações lfp Stores.

Importante :se não for possível encontrar uma loja correspondente, os inventários ou as vendas enviado com o código da loja não será usado. Para ter sucesso com uma taxa de correspondência maior, as informações fornecidas devem corresponder exatamente aos detalhes disponíveis no Google o Maps dessa loja específica.

A resposta de accounts.lfpStores.insert também fornece uma matchingState e matchingState se a correspondência falhar.

Dica :monitore essas respostas para registrar e resolver problemas de correspondência mais cedo ou mais tarde e evitar a construção de lojas sem correspondência, o que não pode ter ofertas veiculadas.