Obtenir les données des produits
Dans les flux de travail utilisant les données des produits, vous pouvez vous servir de l’action Obtenir les données des produits pour récupérer les données des produits dans votre boutique.
Configuration
Champs
L’action Get product data (Obtenir les données des commandes) contient les champs suivants, qui sont utilisés pour créer la requête :
| 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. La quantité maximale de résultats qui peut être renvoyée par la requête de recherche que vous sélectionnez. Vous pouvez en retourner jusqu’à 100 à la fois. |
| Requête | Obligatoire. Choisissez parmi les requêtes courantes ou sélectionnez Avancée pour créer les vôtres. |
Chaîne de requête
Il s’agit d’un exemple de requête pour obtenir des produits qui ont été mis à 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 des produits et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible dans les flux de travail qui utilisent le déclencheur Date/heure prévues. La balise Liquid date_minus est une balise Flow spéciale, qui vous permet de soustraire du temps d’une date.
Lorsque vous requerrez des données, il est utile de connaître ce qui suit :
- Liste des filtres de produit disponibles - Les requêtes doivent suivre une certaine syntaxe
- Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, les valeurs peuvent être trouvées en regardant les documents de l’API. Vous pouvez aussi souvent trouver les valeurs de champ dans les URL de l’interface administrateur lorsque vous filtrez. Par exemple, pour trouver des 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 GraphiQL de Shopify.
- Sachez ce qui se produira si votre requête échoue. Souvent, l’API retournera tous les résultats (au lieu d’aucun).
Données renvoyées
Toutes les actions Obtenir des données renvoient une liste entre 0 et 100 ressource. Selon l’usage que vous en faites, vous voudrez peut-être utiliser ces données de différentes manières :
- Si vous devez gérer chaque article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez utiliser l’action Pour chacun.
- Si vous devez agréger les données, telles que le nombre de résultats retournés, vous pouvez utiliser les actions Quantité ou Somme.
- Si vous avez besoin d’une liste de sorties, comme envoyer un e-mail avec tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions suivantes.
Pour accéder aux données renvoyées selon les étapes qui suivent cette action, utilisez la variable appelée Get product data (Obtenir les données des produits), qui est une liste de produits. Vous pouvez utiliser cette variable à la fois dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des produits dans une action Send internal email (Envoyer un e-mail interne) comme celle-ci :
{% for single_product in GetProductData %}
- {{ single_product.name }}
{% endfor %}Déclencheurs
Vous pouvez utiliser cette action dans n’importe quel flux de travail, y compris dans le déclencheur Date/heure prévues. Dans un flux de travail utilisant le déclencheur Date/heure prévues, le flux démarre à un moment que vous avez spécifié, plutôt qu’à la suite d’un événement. Étant donné qu’il n’y a pas d’événement spécifique dans votre boutique ou provenant d’une application qui démarre le flux de travail, aucune donnée n’est incluse automatiquement.
Détails de l’API
Modèles
Ajouter des produits avec une balise à une collection à une date ultérieure
À une date ultérieure, récupérez tous les produits avec une certaine balise et ajoutez‑les à une collection. Afficher le modèle
Supprimer les produits inactifs
Supprimez les produits sans stock qui n’ont pas été mis à jour depuis un an. Afficher le modèle
Publier les produits avec une certaine balise à une date ultérieure
À une date ultérieure, récupérez les produits avec une certaine balise et publiez-les. Utilise le déclencheur Date/heure prévues et l’action Obtenir les données des produits. Afficher le modèle
Retirer la balise de nouveau produit 90 jours après la création du produit
Reçoit chaque jour jusqu’à 100 produits qui ont été créés il y a plus de 90 jours et qui ont toujours la balise « nouveau ». Le flux de travail supprime ensuite les balises pour chaque produit. Afficher le modèle
Programmer les produits à retirer de la boutique en ligne à la date et à l’heure spécifiées
À une date ultérieure, supprimez des produits de la boutique en ligne en fonction de leur balise, ID ou SKU. Utilise le déclencheur Date/heure prévues, l’action Obtenir les données des produits et boucle Pour chaque. Afficher le modèle
Envoyer un résumé quotidien par e‑mail avec les produits en rupture de stock
Chaque jour, cette fonction récupère tous les produits qui n’ont aucun stock et envoie un résumé par e‑mail. Utilise Obtenir les données des commandes et le déclencheur Date/heure prévues. Afficher le modèle
Envoyer une notification par e‑mail quand une variante est ajoutée avec un SKU en double
Quand une nouvelle variante est ajoutée, cette fonction vérifie si d’autres variantes utilisent le même SKU. Si c’est le cas, un e‑mail interne est envoyé avec des liens vers les produits et les variantes concernés. Afficher le modèle
Suivre les variantes de produits qui sont en vente à l’aide d’un champ méta de produit
Définit un champ méta sur un produit si au moins une de ses variantes est en promotion. Cela peut être utile pour savoir quels produits sont actuellement en vente. Afficher le modèle