Coletar dados de produto

Em fluxos de trabalho que usam dados de produto, é possível usar a ação Get product data ("Coletar dados de produto") para extrair esse tipo de informação da loja.

Observação

É uma ação do tipo Get data ("Coletar dados"). Para entender como usá-la com o acionador Scheduled time ("Horário agendado") e os loops For each ("Para cada"), confira este guia.

Configuração

Campos

A ação Get product data ("Coletar dados de produto") contém estes campos, que são usados para criar a consulta:

Campos usados nas ações "Get data" ("Coletar dados").

Campo	Descrição
Ordenar dados por	Obrigatório. Os parâmetros que ordenam os dados retornados na consulta de pesquisa.
Número máximo de resultados	Obrigatório. Valor máximo de resultados retornados pela consulta de pesquisa selecionada. É possível retornar até 100 de cada vez.
Consulta	Obrigatório. Escolha uma das consultas comuns ou selecione Advanced ("Avançado") para criar a sua.

String da consulta

Este é um exemplo de consulta para coletar produtos 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 em combinação com outras. A variável scheduledAt do Liquid está disponível em fluxos de trabalho que usaram o acionador "Horário agendado". A tag date_minus do Liquid é uma tag especial do Flow que permite subtrair tempo de uma data.

Na hora de consultar dados, é útil conhecer:

• Lista de filtros disponíveis para produtos - As consultas precisam seguir uma determinada sintaxe.
• Nem sempre os valores do campo de consulta estão documentados. Em alguns casos, eles podem ser encontrados na documentação da API. Também é possível encontrar com filtros os valores de campo nos URLs do admin. Por exemplo, para ver alguns valores da consulta de pedido, filtre a página "Pedidos" no admin e verifique o URL.
• É possível usar o app GraphiQL da Shopify para executar ou testar uma consulta na loja.
• Esteja ciente de que, se a consulta falhar, a API muitas vezes retornará todos os resultados, em vez de nenhum.

Dados retornados

Todas as ações Geta data ("Coletar dados") retornam uma lista com 0 a 100 recursos. Conforme o caso de uso, é possível usar esses dados de várias maneiras:

• Se for necessário lidar com cada item de lista individualmente, por exemplo, para adicionar uma tag, use a ação For each ("Para cada").
• Se for necessário agregar dados, como contar quantos resultados foram retornados, use as ações Count ("Contar") ou Sum ("Somar").
• Se for necessário gerar uma lista, por exemplo, para enviar um e-mail com todos os itens, use os dados retornados diretamente nas ações subsequentes.

Para acessar os dados retornados nas etapas seguintes à ação, use a variável denominada Get product data ("Coletar dados de produto"), que é uma lista dos produtos. Essa variável pode ser usada em condições e em ações. Por exemplo, é possível enviar a lista de produtos em uma ação Send internal email ("Enviar e-mail interno") como esta:

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

Observação

Se a ação Get data ("Coletar dados") for usada várias vezes em um único fluxo de trabalho, um número será adicionado ao nome da variável. Por exemplo, em um fluxo de trabalho que usa a ação Get order data ("Coletar dados de pedido") duas vezes, a primeira variável para os dados retornados é getOrderData e a segunda variável é getOrderData1. Vale lembrar que o nome não pode ser personalizado.

Acionadores

Essa ação pode ser usada em todos os fluxos de trabalho, incluindo o acionador Scheduled time ("Horário agendado"). Os fluxos de trabalho com esse acionador se iniciam no momento que você especificou, 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, não há dados incluídos de forma automática.

Informações da API

• Recurso para produtos
• Filtros de consulta para produtos

Modelos

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

No futuro, coloque uma determinada tag em todos os produtos e adicione-os a uma coleção. Ver modelo

Excluir produtos inativos

Exclua produtos sem estoque que não foram atualizados durante o ano. Ver modelo

Publicar produtos com uma determinada tag no futuro

No futuro, publique produtos com uma determinada tag. Use o acionador "Horário agendado" e a ação "Coletar dados de produto". Ver modelo

Remover tag de produto novo 90 dias após a criação do item

Todos os dias, analisa até 100 produtos criados há mais de 90 dias que ainda têm a tag "Novo". Em seguida, o fluxo de trabalho remove essas tags de cada item. Ver modelo

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

Em uma data no futuro, remova produtos da loja virtual por tag, ID ou SKU. Esse fluxo de trabalho usa o acionador "Horário agendado", a ação "Coletar dados de produto" e o loop "Para cada". Ver modelo

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

Todos os dias, você recebe por e-mail um resumo de todos os produtos com estoque zerado. Usa os acionadores "Get product data" ("Coletar dados de produto") e "Scheduled time" ("Horário agendado"). Ver modelo

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

Quando uma nova variante é adicionada, verifica se alguma outra usa a mesma SKU. Em caso positivo, o fluxo de trabalho enviará um e-mail interno com links para os produtos e variantes afetados. Ver modelo

Acompanhar as variantes de produtos 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