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.

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:

Campos usados nas ações "Get data" ("Coletar dados").
CampoDescrição
Ordenar dados porObrigatório. Os parâmetros que ordenam os dados retornados na consulta de pesquisa.
Número máximo de resultadosObrigatório. Valor máximo de resultados retornados pela consulta de pesquisa selecionada. É possível retornar até 100 de cada vez.
ConsultaObrigató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.

Referência da API

Não encontrou as respostas que está procurando? Estamos sempre à disposição para ajudar você.