Nesta página, listamos um conjunto de tutoriais interativos da API Google Retail que incluem ações que podem ser executadas no editor do Google Cloud Shell. Com essa ferramenta, você pode programar, criar, testar, executar e depurar aplicativos nativos da nuvem diretamente do seu navegador.
Visão geral
Faça tutoriais diferentes dependendo do que você quer aprender:
Se você estiver iniciando um projeto, tente os tutoriais Importar informações do catálogo. Aqui, você aprenderá a importar produtos para o catálogo e testar, por exemplo, diferentes funcionalidades de pesquisa. Em seguida, consulte os tutoriais Importar eventos históricos de usuários. A API Retail usa eventos de usuário para gerar recomendações iniciais e resultados da pesquisa. Em seguida, siga os tutoriais Gravar eventos de usuário em tempo real. A API Retail usa eventos de usuários em tempo real para fornecer resultados de alta qualidade e relevantes.
Se você tiver interesse em saber como a pesquisa funciona, consulte os tutoriais da Pesquisa.
Se você quiser saber como configurar a pesquisa com configurações e controles de veiculação, consulte os seguintes tutoriais:
Se você precisar atualizar as informações do seu catálogo, consulte os tutoriais Gerenciar informações do catálogo.
Se você quiser saber como atualizar o inventário, consulte os tutoriais Atualizar o inventário da Retail Search.
Para saber como gravar, ver ou remover eventos de usuário em tempo real, consulte os tutoriais Gravar eventos de usuário em tempo real.
Se você planeja usar o Recommendations AI, consulte os tutoriais de importação e gerenciamento de catálogos e eventos de usuário.
Importar informações do catálogo
Estes tutoriais descrevem como importar as informações do catálogo para a API Retail e mantê-las atualizadas.
Importar dados do catálogo do BigQuery
Neste tutorial, mostramos como usar uma tabela do BigQuery para importar grandes quantidades de dados de catálogo sem limites.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar dados do catálogo do Cloud Storage
Este tutorial mostra como importar um grande número de itens para um catálogo.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar dados do catálogo in-line
Neste tutorial, mostramos como importar produtos para um catálogo in-line.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Gerenciar informações do catálogo
Nestes tutoriais, descrevemos como gerenciar as informações do produto depois que você importar um catálogo para a API Retail. É possível ler, gravar e excluir produtos no seu catálogo.
Saiba como chamar a API Google Cloud Retail com a linguagem que você preferir.
Tutorial de criação, recebimento, atualização e exclusão de produtos
Neste tutorial, mostramos como usar os métodos de serviço de produto da API Retail, que executam as seguintes ações:
- Criar um produto
- Receber um produto
- Atualizar um produto
- Excluir um produto
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de criação de produtos
Neste tutorial, mostramos como criar um único produto.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de recebimento de produtos
Neste tutorial, mostramos como recuperar um item de produto.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de atualização de produtos
Neste tutorial, mostramos como atualizar um produto em um catálogo.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de exclusão de produtos
Neste tutorial, mostramos como excluir um produto de um catálogo.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Importar eventos históricos do usuário
Estes tutoriais descrevem como importar dados de eventos do usuário de eventos anteriores em massa. Os modelos da API Retail exigem dados de evento do usuário para treinamento.
Tutorial de importação de eventos do Cloud Storage
Neste tutorial, mostramos como importar eventos de usuários do Cloud Storage.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de importação de eventos do BigQuery
Neste tutorial, mostramos como importar eventos de usuários do BigQuery.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de importação de eventos inline
Neste tutorial, mostramos como importar dados de eventos de usuário in-line.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Registrar eventos do usuário em tempo real
Estes tutoriais descrevem como gravar, ver ou remover eventos de usuário em tempo real. A API Retail usa eventos de usuário em tempo real para gerar recomendações e resultados de pesquisa. Gravar o maior número possível de eventos do usuário com informações válidas do produto aumenta a qualidade dos resultados.
Tutorial para criar eventos de usuário
Neste tutorial, mostramos como registrar eventos de usuário usando o
método
userEvents.write.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de reintegração de eventos de usuário
Neste tutorial, mostramos como unir novamente eventos de usuário fazendo uma solicitação POST para o
endpoint userEvents:rejoin.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial para remover eventos de usuário
Este tutorial mostra como limpar eventos de usuário.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Pesquisar tutoriais
O método search() da API Retail é usado para pesquisar no catálogo de acordo com a consulta de pesquisa e outros parâmetros, como filter, facet ou order_by.
Por padrão, a resposta da pesquisa contém um número razoável de resultados ordenados por relevância.
Tutorial de consultas
Neste tutorial, mostramos como enviar uma consulta de pesquisa simples para o serviço do Retail e como analisar a resposta.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de paginação
Neste tutorial, mostramos como controlar a paginação na solicitação de pesquisa. Quando um comprador procura produtos em uma loja, ele pode melhorar a navegação por meio dos resultados da pesquisa. Por exemplo, eles podem limitar o número de itens na resposta da pesquisa usando o recurso de tamanho de página ou ir para a página preferida usando o recurso de deslocamento.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de expansão de consulta
Neste tutorial, mostramos como ativar o recurso de expansão de consulta. Quando um comprador usa uma frase de pesquisa ambígua ou de várias palavras, ele pode receber uma resposta vazia. Depois de ativar a expansão de consulta, a Retail Search analisa a solicitação e retorna a lista expandida de produtos com base na consulta de pesquisa analisada.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de filtragem
Este tutorial demonstra o recurso de filtragem. Ele permite ajustar as solicitações de pesquisa de acordo com as suas necessidades ou as de clientes. É possível filtrar por um ou vários campos, filtrar por texto, campos numéricos ou ambos. É possível usar uma linguagem de expressão para construir um predicado para cada campo ou combinar expressões diferentes usando operadores lógicos. Por exemplo, um comprador que procura sapatos pode usar filtros para restringir a pesquisa à marca e cor que preferir.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de ordenação
Este tutorial mostra como ordenar os itens em uma resposta de pesquisa. Quando um comprador procura um produto no seu site, a Retail Search pode mostrar resultados ordenados por vários campos. Por exemplo, uma compradora está procurando um vestido com o melhor preço e desconto. "Preço e desconto" são vários campos. A Retail Search mostrará os vestidos do comprador encomendados por preço e, para os vestidos com o mesmo preço, ordenados por desconto.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de otimização
Neste tutorial, mostramos alguns exemplos de otimização de produtos nos resultados da pesquisa. Com o aumento, você pode aplicar um impulso a um produto para priorizá-lo ou diminuir a prioridade nos resultados da pesquisa.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de controle de redirecionamento
Este tutorial mostra como usar o controle de redirecionamento. O controle de redirecionamento permite que você especifique um URL para o qual redirecionar usuários quando usarem uma consulta de pesquisa específica. Por exemplo, se um usuário solicita "produtos de produção sustentáveis", é possível redirecioná-lo para uma página que contém as marcas ambientais com que você está trabalhando.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Atualizar o inventário da Retail Search
Embora os métodos de criação, leitura, atualização e exclusão (CRUD, na sigla em inglês) Product sejam usados para
modificar amplamente os atributos de um Product, há um conjunto de métodos Product
que pode ser usado para atualizar campos específicos de inventário com níveis diferentes de
granularidade. Os campos Product a seguir são considerados campos de inventário:
Product.price_infoProduct.availabilityProduct.available_quantityProduct.fulfillment_info
Tutorial de adição de fulfillment
Neste tutorial, mostramos como atualizar informações de fulfillment do produto usando o
método
AddFulfillmentPlaces. Dessa forma, a Retail Search pode mostrar atualizações de onde os produtos estão disponíveis e de que os pedidos podem ser atendidos. Por exemplo, um comprador está procurando jeans azuis em uma loja, mas eles estão em falta. Quando os jeans estiverem em estoque novamente nesta loja ou em qualquer outra, a Retail Search mostrará as atualizações, e o comprador poderá prosseguir com o pedido.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de remoção de fulfillment
Neste tutorial, mostramos como atualizar informações de fulfillment do produto usando o método [RemoveFulfillmentPlaces][remove-fulfillment-places]. Dessa forma, a Retail Search pode mostrar atualizações em que os produtos não estão disponíveis e os pedidos não são atendidos. Por exemplo, um comprador está procurando jeans azuis em uma loja. Se a calça jeans estiver esgotado nessa loja, a Retail Search mostrará as atualizações, e o comprador não vai poder prosseguir com o pedido.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação:
Tutorial de configuração do inventário
Neste tutorial, mostramos como enviar atualizações de inventário usando o
método SetInventory
em vez de atualizar todo o produto.
Para seguir as instruções passo a passo desta tarefa diretamente no editor do Cloud Shell, clique em Orientação: