Buscar dados de produtos

Em fluxos de trabalho que usam dados de produtos, é possível usar a ação Buscar dados de produtos para recuperar informações de produtos da loja.

Configuração

Campos

A ação Buscar dados de produtos contém os seguintes campos, que são usados para criar a consulta:

String de consulta

Este é um exemplo de consulta para buscar produtos que foram atualizados no último dia:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

A variável updated_at é um filtro disponível na consulta de Produtos e pode ser usada várias vezes ou combinada com outras variáveis. A variável scheduledAt do Liquid está disponível em fluxos de trabalho que usam o acionador Horário agendado. A tag date_minus do Liquid é uma tag especial do Flow que permite subtrair tempo de uma data.

Ao consultar dados, é útil saber o seguinte:

• Lista de filtros de produtos disponíveis
• As consultas precisam seguir uma sintaxe específica
• Os valores dos campos de consulta nem sempre são documentados. Em alguns casos, os valores podem ser encontrados na documentação da API. Como alternativa, muitas vezes é possível encontrar os valores dos campos nos URLs no painel do admin ao aplicar filtros. Por exemplo, para encontrar alguns valores de consulta de Pedido, filtre a página Pedidos no painel do admin e verifique o URL.
• É possível executar ou testar uma consulta na loja usando o app Shopify GraphiQL.
• Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retornará todos os resultados (em vez de nenhum).

Dados retornados

Todas as ações Buscar dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, esses dados podem ser usados de várias maneiras:

• Se for preciso processar cada item da lista individualmente, por exemplo, para adicionar uma tag a cada um, use a ação Para cada item.
• Se for preciso agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
• Se for preciso exibir a lista, como no envio de um e-mail com todos os itens, é possível usar os dados retornados diretamente em ações subsequentes.

Para acessar os dados retornados nas etapas seguintes a essa ação, use a variável chamada Buscar dados de produtos, que é uma lista de produtos. É possível usar essa variável em condições e ações. Por exemplo, você pode enviar a lista de produtos em uma ação Enviar e-mail interno desta forma:

{% for single_product in GetProductData %}
* {{ single_product.name }}
{% endfor %}

Acionadores

É possível usar esta ação em qualquer fluxo de trabalho, incluindo o acionador Horário agendado. Em um fluxo de trabalho que usa o acionador Horário agendado, o fluxo de trabalho é iniciado em um horário especificado, e não como resultado de um evento. Como não há nenhum evento específico na loja ou de um app que inicie o fluxo de trabalho, nenhum dado é incluído automaticamente.

Detalhes da API

• Recurso do produto
• Filtros de consulta de produtos

Modelos

Adicionar produtos com uma tag a uma coleção no futuro

Em uma data futura, obtém todos os produtos com uma tag específica e os adiciona a uma coleção. Ver modelo

Excluir produtos inativos

Exclui produtos sem estoque que não foram atualizados há um ano. Ver modelo

Publicar produtos com uma tag específica no futuro

Em uma data futura, obtém produtos com uma tag específica e os publica. Usa o acionador de horário agendado e a ação para obter dados do produto. Ver modelo

Remover a tag de produto “new” 90 dias após a criação

Todos os dias, busca até 100 produtos criados há mais de 90 dias que ainda tenham a tag “new”. Em seguida, o fluxo de trabalho remove essas tags de cada produto. Ver modelo

Agendar a remoção de produtos da Loja virtual em data e hora especificadas

Em uma única data futura, remove produtos da loja virtual por tag, ID ou SKU. Usa o acionador de horário agendado, a ação Obter dados do produto e o loop Para cada item. Ver modelo

Enviar resumo diário por e-mail com produtos sem estoque

Todos os dias, busca todos os produtos com estoque 0 e envia um resumo por e-mail. Usa a ação Obter dados do produto e o acionador de horário agendado. Ver modelo

Enviar notificação por e-mail quando uma variante for adicionada com um SKU duplicado

Quando uma nova variante é adicionada, o sistema verifica se outras usam o mesmo SKU. Em caso afirmativo, um e-mail interno é enviado com links para os produtos e as variantes em questão. Ver modelo

Rastrear variantes de produto em promoção usando um metacampo de produto

Define um metacampo em um produto se pelo menos uma de suas variantes estiver em promoção. Isso pode ser útil para rastrear quais produtos estão em promoção no momento. Ver modelo