Obter dados da página

Nos fluxos de trabalho que exigem dados da página, use a ação Obter dados da página para recuperar essas informações da loja. Páginas são aquelas na loja virtual que contêm informações que raramente mudam, como a página Quem somos ou a de Contato.

Nesta página

Configuração

Campos

A ação Obter dados da página contém os seguintes campos:

Campos usados nas ações Obter dados.
Campo	Descrição
Classificar dados por	Obrigatório. Os parâmetros que classificam os dados retornados pela consulta de pesquisa.
Número máximo de resultados	Obrigatório. A quantidade máxima de resultados que podem ser retornados pela consulta de pesquisa selecionada. É possível retornar até 100 de cada vez.
Consulta	Obrigatório. Escolha entre consultas comuns ou selecione Avançado para criar a sua.

String de consulta

Este é um exemplo de consulta para obter páginas publicadas:

published_status:published

A variável published_status é um filtro disponível na consulta de Páginas que pode ser usado diversas vezes ou combinado com outras variáveis.

Ao consultar dados, é útil saber:

Lista de filtros de página disponíveis
As consultas precisam seguir uma determinada sintaxe
Os valores dos campos de consulta nem sempre estão documentados. Em alguns casos, é possível encontrar os valores examinando a documentação da API. Como alternativa, é comum encontrá-los nos URLs do painel do admin ao usar filtros. Por exemplo, para localizar alguns valores de consulta de pedidos, 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.
Preste atenção ao que acontece em caso de falha na consulta. 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. A depender do caso de uso, é possível utilizar esses dados de várias maneiras:

Se for preciso processar os itens da lista individualmente, como incluir uma tag em cada um deles, você poderá usar a ação Para cada.
Caso precise agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Somar.
Se for preciso gerar uma lista (por exemplo, para enviar um e-mail com todos os itens), será possível usar os dados retornados de modo direto em ações subsequentes.

Para acessar os dados retornados nas etapas após essa ação, use a variável chamada Obter dados da página, que é uma lista de páginas. É possível usar essa variável tanto em condições quanto em ações. Por exemplo, você pode enviar a lista de páginas em uma ação Enviar e-mail interno semelhante a esta:

{% for single_page in getPageData %}
  * {{ single_page.title }} - {{ single_page.handle }}
{% endfor %}

Acionadores

Use essa ação em qualquer fluxo de trabalho, inclusive no acionador Horário agendado. Em fluxos de trabalho que o utilizam, a execução é iniciada no horário que você especificar, e não como resultado de um evento. Como não há um evento específico na loja ou em um app para iniciar o fluxo de trabalho, os dados não são incluídos de forma automática.

Referência da API

Para saber mais sobre a API usada nessa ação, consulte a consulta de Páginas.