Obtenir les données sur les variantes de produit
Dans les flux de travail qui utilisent des données sur les variantes de produit, vous pouvez utiliser l’action Obtenir les données sur les variantes de produit pour récupérer les informations sur les variantes de produit dans votre boutique.
Configuration
Champs
L’action Obtenir les données sur les variantes de produit contient les champs suivants, qui sont utilisés pour élaborer la requête :
| Champ | Description |
|---|---|
| Trier les données par | Requis. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées. |
| Nombre maximal de résultats | Requis. Le nombre maximal de résultats pouvant être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois. |
| Requête | Requis. Choisissez parmi des requêtes courantes ou sélectionnez Avancé pour créer la vôtre. |
Chaîne de requête
Voici un exemple de requête pour obtenir les variantes de produit qui ont été mises à jour au cours du dernier jour :
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variable updated_at est un filtre disponible dans la requête Product Variants et peut être utilisée plusieurs fois ou combinée avec d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Heure programmée. La balise Liquid date_minus est une balise Flow spéciale qui vous permet de soustraire du temps à une date.
Lorsque vous interrogez des données, il est utile de savoir ce qui suit :
- Liste des filtres de variantes de produit disponibles
- Les requêtes doivent respecter une certaine syntaxe
- Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, vous pouvez trouver les valeurs en consultant la documentation de l’API. Sinon, vous pouvez 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 en utilisant l’application Shopify GraphiQL.
- Soyez attentif à ce qui se passe si votre requête échoue. Souvent, l’API renvoie tous les résultats (au lieu de n’en renvoyer aucun).
Données renvoyées
Toutes les actions Obtenir les données renvoient une liste de 0 à 100 ressources. Selon votre cas d’utilisation, vous pouvez utiliser ces données de plusieurs façons :
- Si vous devez traiter chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez alors utiliser l’action For each.
- Si vous devez agréger des données, par exemple pour compter le nombre de résultats renvoyés, vous pouvez alors utiliser les actions Compter ou Somme.
- Si vous devez utiliser la liste entière, par exemple pour envoyer un e-mail avec tous les articles, vous pouvez alors 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 sur les variantes de produit, qui est une liste de variantes de produit. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des commandes dans une action Envoyer un e-mail interne comme ceci :
{% for single_variant in GetProductVariantData %}
* {{ single_variant.name }}
{% endfor %}Déclencheurs
Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris avec le déclencheur Heure programmée. Dans ce cas, le flux de travail démarre à une heure que vous avez définie, et non suite à un événement. Étant donné qu’aucun événement spécifique provenant de votre boutique ou d’une appli ne lance le flux de travail, aucune donnée n’est incluse automatiquement.
Détails de l’API
Modèles
Ajouter un article gratuit (réduction de 100 %) aux nouvelles commandes
Ce modèle ajoute un article gratuit avec réduction aux nouvelles commandes si l’article est en stock. Il vérifie le stock, applique une réduction de 100 % et met à jour la commande sans en aviser le client. Cette automatisation est utile pour (1) améliorer la satisfaction des clients en incluant un article surprise gratuit dans leur commande, (2) promouvoir des produits nouveaux ou moins connus en les ajoutant comme échantillons gratuits aux commandes, ou (3) simplifier les promotions en automatisant l’inclusion d’articles gratuits et l’application de la réduction. Afficher le modèle
Envoyer un résumé hebdomadaire par e-mail avec la liste des variantes à stock faible
Ce flux de travail s’exécute de manière programmée (par exemple, une fois par semaine). Il récupère une liste de variantes de produit à stock faible, compte les résultats et envoie un résumé par e-mail contenant les titres des variantes et un lien vers la page des variantes dans l’interface administrateur. Afficher le modèle