Obtenir des données de marché

Dans les flux de travail nécessitant des données de marché, vous pouvez utiliser l’action Obtenir des données de marché pour récupérer des informations sur les marchés de votre boutique Shopify. Les marchés sont des groupes de régions ou d'emplacements que vous ciblez pour vos ventes.

Sur cette page

Configuration

Champs

L’action Obtenir des données de marché contient les champs suivants :

Champs utilisés dans les actions Obtenir des données.
Champ	Description
Trier les données par	Obligatoire. Paramètres selon lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximum de résultats	Obligatoire. Nombre maximum de résultats pouvant être renvoyés par la requête de recherche que vous avez sélectionnée. Il est possible de renvoyer jusqu’à 100 résultats à la fois.
Requête	Obligatoire. Faites votre choix parmi les requêtes courantes ou sélectionnez Avancé pour créer la vôtre.

Chaîne de requête

Voici un exemple de requête permettant d’obtenir tous les marchés actifs :

status:ACTIVE

La variable status est un filtre disponible pour la requête Markets et peut être utilisée plusieurs fois ou combinée avec d’autres variables.

Lorsque vous interrogez des données, il est utile de savoir ce qui suit :

Liste des filtres de marché disponibles
Les requêtes doivent suivre une syntaxe spécifique
Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, il est possible de trouver ces valeurs en consultant la documentation de l’API. Vous pouvez également souvent trouver les valeurs des champs dans les URL de l'interface administrateur lorsque vous appliquez un filtre. Par exemple, pour trouver certaines valeurs de requête de commande, filtrez la page Commandes dans l’interface administrateur, puis vérifiez l’URL.
Vous pouvez exécuter ou tester une requête dans votre boutique à l’aide de l’application Shopify GraphiQL.
Faites attention à ce qui se produit en cas d'échec de votre requête. Souvent, l’API renvoie tous les résultats (au lieu d'aucun).

Données renvoyées

Toutes les actions Obtenir des données renvoient une liste contenant de 0 à 100 ressources. Selon votre cas d'utilisation, vous pouvez utiliser ces données de différentes manières :

Si vous devez traiter chaque élément de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chaque.
Si vous devez agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez utiliser les actions Compter ou Somme.
Si vous devez générer la liste, par exemple pour envoyer un e-mail contenant tous les éléments, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Obtenir les données du marché, qui est une liste de marchés. Vous pouvez utiliser cette variable à la fois dans les conditions et dans les actions. Par exemple, vous pouvez envoyer la liste des marchés dans une action Envoyer un e-mail interne semblable à celle-ci :

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Déclencheurs

Vous pouvez utiliser cette action dans n'importe quel flux de travail, y compris le déclencheur Heure programmée. Dans un flux de travail qui utilise le déclencheur Heure programmée, le flux de travail commence à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Étant donné qu’il n’y a aucun événement spécifique dans votre boutique ou provenant d’une application qui démarre le flux de travail, aucune donnée n’est automatiquement incluse.

Référence de l'API

Pour plus d'informations sur l'API utilisée dans cette action, consultez la requête Markets.