Obter dados de cartão-presente

Em fluxos de trabalho que exigem dados de cartão-presente, você pode usar a ação Obter dados de cartão-presente para recuperar informações de cartões-presente da sua loja.

É importante destacar que sua loja tem tanto os produtos de cartão-presente, que são usados para gerar os cartões-presente, quanto os próprios cartões-presente, que são os cartões que os clientes podem usar para fazer compras. A ação Obter dados de cartão-presente recupera informações sobre os próprios cartões-presente. Para obter informações sobre produtos de cartão-presente, use as ações Obter dados do produto ou Obter dados da variante do produto.

Nesta página

Configuração

Campos

A ação Obter dados de cartão-presente contém os seguintes campos, que são usados para criar a consulta:

Campos usados nas ações Obter dados.
Campo	Descrição
Classificar dados por	Obrigatório. Os parâmetros pelos quais os dados retornados pela consulta de pesquisa são classificados.
Número máximo de resultados	Obrigatório. O número máximo de resultados que podem ser retornados pela consulta de pesquisa que você selecionou. É possível retornar até 100 de uma vez.
Consulta	Obrigatório. Escolha uma das consultas comuns ou selecione Avançado para criar a sua.

String de consulta

Este é um exemplo de consulta para obter cartões-presente atualizados no último dia:

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

A variável created_at é um filtro disponível na consulta de cartões-presente 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 cartão-presente disponíveis
As consultas precisam seguir uma sintaxe específica
Os valores dos campos de consulta nem sempre estão documentados. Em alguns casos, é possível encontrar os valores na documentação da API. Outra opção é consultar os valores dos campos nas URLs do admin ao aplicar filtros. Por exemplo, para encontrar alguns valores de consulta de pedidos, filtre a página Pedidos no admin e verifique a URL.
É possível executar ou testar uma consulta na sua loja com o app Shopify GraphiQL.
Tenha atenção ao que acontece se a consulta falhar. Muitas vezes, a API retorna todos os resultados (em vez de nenhum).

Dados retornados

Todas as ações Obter dados retornam uma lista de 0 a 100 recursos. Dependendo do caso de uso, é possível usar esses dados de várias maneiras:

Caso seja necessário processar cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
Caso seja necessário agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
Caso precise da lista como resultado, por exemplo, para enviar um e-mail com todos os itens, use os dados retornados diretamente em ações subsequentes.

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

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.name }}
{% endfor %}

Acionadores

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