Obter dados do grupo de planos de venda
Em workflows que exigem dados de grupos de planos de venda, use a ação Obter dados do grupo de planos de venda para recuperar informações de pedidos da loja.
Configuração
Campos
A ação Obter dados do grupo de planos de venda contém os seguintes campos, usados para criar a consulta:
| 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ê selecionar. É possível retornar até 100 por vez. |
| Consulta | Obrigatório. Escolha entre as consultas comuns ou selecione Avançado para criar a sua. |
String de consulta
Este é um exemplo de consulta para obter grupos de planos de venda atualizados no último dia:
name='Subscribe & Save'A variável category é um filtro disponível na consulta de grupo de planos de venda e pode ser usada para selecionar categorias específicas de grupos de planos de venda.
Ao consultar dados, é útil saber:
- Lista de filtros de grupo de planos de venda disponíveis
- As consultas precisam seguir uma determinada sintaxe
- 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, você pode encontrar os valores dos campos nos URLs do admin ao aplicar filtros. Por exemplo, para encontrar alguns valores de consulta de pedido, filtre a página Pedidos no admin e verifique o URL.
- É possível executar ou testar uma consulta na sua loja com o app Shopify GraphiQL.
- Fique atento 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 seu caso de uso, você pode usar esses dados de várias maneiras:
- Se precisar lidar com cada item da lista individualmente, como adicionar uma tag a cada um, use a ação Para cada.
- Se precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Soma.
- Se precisar gerar a lista, como enviar um e-mail com todos os itens, poderá usar os dados retornados diretamente nas ações subsequentes.
Para acessar os dados retornados nas etapas seguintes a esta ação, use a variável chamada Obter dados do grupo de planos de venda, que é uma lista de grupos de planos de venda. Essa variável pode ser usada em condições e ações. Por exemplo, você pode 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 workflow está programado para ser executado todo domingo às 9h. A ação Obter dados do grupo 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 mais vendidos, a position do grupo de planos de venda poderá aumentar.