Obter dados do local
Em workflows que exigem dados de local, use a ação Obter dados do local para recuperar informações de locais da sua loja na Shopify. Locais são quaisquer lugares onde você armazena estoque, vende produtos ou envia ou processa pedidos.
Configuração
Campos
A ação Obter dados do local contém os seguintes campos.
| 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. A quantidade máxima de resultados que podem ser retornados pela consulta de pesquisa que você seleciona. É possível retornar até 100 por 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 locais que têm a retirada na loja habilitada:
pickup_in_store:enabledA variável pickup_in_store é um filtro disponível na consulta “Locations” e pode ser usada várias vezes ou combinada com outras variáveis.
Ao consultar dados, é útil saber o seguinte:
As consultas precisam seguir uma sintaxe específica
Os valores de campo da consulta nem sempre são documentados. Em alguns casos, eles podem ser encontrados na documentação da API. Como alternativa, é comum encontrar os valores dos campos nos URLs do admin da Shopify após aplicar um filtro. 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 em sua loja usando o app Shopify GraphiQL.
Fique atento ao que acontece se a consulta falhar. Muitas vezes, a API retornará 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 você precisar lidar com cada item da lista individualmente, como para adicionar uma tag a cada um, use a ação Para cada.
- Se você precisar agregar dados, como contar quantos resultados foram retornados, use as ações Contar ou Soma.
- Se você precisar exibir a lista, como para 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 que se seguem a esta ação, use a variável chamada Obter dados do local, que é uma lista de locais. Você pode usar essa variável em condições e ações. Por exemplo, você pode enviar a lista de locais em uma ação Enviar e-mail interno como esta:
{% for single_location in GetLocationData %}
* {{ single_location.id }}
{% endfor %}Acionadores
Você pode usar essa ação em qualquer workflow, incluindo o acionador Horário agendado. Em um workflow que usa o acionador Horário agendado, o workflow é iniciado em um horário especificado por você, e não como resultado de um evento. Como não há um evento específico em sua loja ou de um app que inicie o workflow, nenhum dado é incluído automaticamente.
Referência da API
Para saber mais sobre a API usada nesta ação, consulte a consulta “Locations”.