Obter dados de grupos de planos de venda
Nos fluxos de trabalho que exigem dados de grupos de planos de venda, use a ação Obter dados de grupos de planos de venda para recuperar as informações do pedido da loja.
Nesta página
Configuração
Campos
A ação Obter dados de grupos de planos de venda contém estes campos, que são usados para criar a consulta:
| 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 obter grupos de planos de venda que foram atualizados no último dia:
name='Subscribe & Save'A variável category é um filtro disponível na consulta de grupos de planos de venda e pode ser usada para selecionar categorias específicas de grupos de planos de venda.
Quando consultar dados, é útil conhecer:
- Lista de filtros de grupos de planos de venda disponíveis - As consultas precisam seguir uma determinada sintaxe.
- Os nomes de campo de todas as consultas podem ser encontrados na documentação para desenvolvedores do objeto QueryRoot.
- 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 Obter dados de grupos de planos de venda, que é uma lista de grupos de planos de venda.Essa variável pode ser usada em condições e em ações.Por exemplo, é possível enviar a lista de grupos de planos de venda em uma ação Enviar e-mail interno como esta:
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}Exemplo
Por exemplo, um fluxo de trabalho é agendado para ser executado todos os domingos, às 9h. A ação Obter dados de grupos de planos de venda é usada para coletar dados de grupos de planos de venda criados na última semana. Se os produtos associados aos grupos de planos de venda forem os seus mais vendidos, a position do grupo de planos de venda poderá aumentar.