Obtenir les données sur les produits
Dans les flux de travail qui utilisent des données sur les produits, vous pouvez utiliser l’action Obtenir les données sur les produits pour récupérer les informations sur les produits de votre boutique.
Configuration
Champs
L’action Obtenir les données sur les produits contient les champs suivants, qui sont utilisés pour créer la requête :
| Champ | Description |
|---|---|
| Trier les données par | Obligatoire. Les paramètres selon lesquels les données renvoyées par la requête de recherche sont triées. |
| Nombre maximum de résultats | Obligatoire. Le nombre maximum de résultats qui peuvent être renvoyés par la requête de recherche que vous sélectionnez. Vous pouvez en renvoyer jusqu’à 100 à la fois. |
| Requête | Obligatoire. Choisissez 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 pour obtenir les 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 sur la requête de produits 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 produits 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 ces valeurs en consultant la documentation de l’API. Vous pouvez également trouver les valeurs des champs dans les URL de l’interface administrateur lorsque vous appliquez des filtres. 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.
- Soyez attentif à ce qui se passe en cas d’échec de votre requête. Souvent, l’API renvoie tous les résultats (au lieu de n’en renvoyer aucun).
Données renvoyées
Toutes les actions Obtenir des données renvoient une liste 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 article de la liste individuellement, par exemple pour ajouter une balise à chacun, vous pouvez alors 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 alors utiliser les actions Compter ou Somme.
- Si vous devez produire la liste en sortie, par exemple pour envoyer un e-mail contenant 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 produits, qui est une liste de produits. Vous pouvez utiliser cette variable dans des conditions et des actions. Par exemple, vous pouvez envoyer la liste de produits dans une action Envoyer un e-mail interne comme suit :
{% 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 avec le déclencheur Heure programmée. Dans un flux de travail qui utilise le déclencheur Heure programmée, le flux de travail démarre à une heure que vous avez spécifiée, plutôt qu’à la suite d’un événement. Comme aucun événement spécifique dans votre boutique ou provenant d’une application ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.
Détails de l’API
Modèles
Ajouter ultérieurement des produits avec une balise à une collection
Récupère tous les produits dotés d’une certaine balise à une date ultérieure, puis les ajoute à une collection. Afficher le modèle
Supprimer les produits inactifs
Supprime les produits sans stock qui n’ont pas été mis à jour depuis un an. Afficher le modèle
Publier ultérieurement des produits dotés d’une certaine balise
À une date ultérieure, récupère les produits dotés d’une certaine balise et les publie. Utilise le déclencheur Heure programmée et l’action Obtenir les données sur le produit. Afficher le modèle
Supprimer la balise de produit « nouveau » 90 jours après la création du produit
Chaque jour, récupère jusqu’à 100 produits créés il y a plus de 90 jours et qui portent encore la balise « nouveau ». Le flux de travail supprime ensuite ces balises pour chaque produit. Afficher le modèle
Programmer la suppression de produits de la Boutique en ligne à la date et à l’heure spécifiées
À une date ultérieure unique, supprime les produits de la boutique en ligne par balise, ID ou SKU. Utilise le déclencheur Heure programmée, l’action Obtenir les données sur le produit et la boucle For each. Afficher le modèle
Envoyer un résumé quotidien par e-mail des produits en rupture de stock
Chaque jour, récupère tous les produits dont le stock est nul et envoie un résumé par e-mail. Utilise l’action Obtenir les données sur le produit et le déclencheur Heure programmée. Afficher le modèle
Envoyer une notification par e-mail lorsqu’une variante avec un SKU en double est ajoutée
Lorsqu’une nouvelle variante est ajoutée, le flux vérifie si d’autres variantes utilisent le même SKU. Si c’est le cas, il envoie un e-mail interne contenant des liens vers les produits et les variantes concernés. Afficher le modèle
Suivre les variantes de produit en promotion à l’aide d’un champ méta de produit
Définit un champ méta sur un produit si au moins l’une de ses variantes est en promotion. Cela peut être utile pour suivre les produits qui sont actuellement en promotion. Afficher le modèle