Obtenir les données de catalogue
Dans les flux de travail qui nécessitent des données de catalogue, vous pouvez utiliser l’action Obtenir les données de catalogue pour récupérer les informations de catalogue B2B de votre boutique. Les catalogues sont des groupes de produits avec une tarification personnalisée pour des clients B2B spécifiques ou des emplacements d’entreprise.
Configuration
Champs
L’action Obtenir les données de catalogue contient les champs suivants :
| Champ | Description |
|---|---|
| Trier les données par | Requis. 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 maximum 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 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 tous les catalogues actifs :
status:ACTIVELa variable status est un filtre disponible pour la requête de catalogues. Elle peut être utilisée plusieurs fois ou combinée avec d’autres variables.
Lors de l’interrogation des données, il est utile de savoir ce qui suit :
Les requêtes doivent respecter une certaine syntaxe
Les valeurs des champs de requête ne sont pas toujours documentées. Dans certains cas, il est possible de les trouver en consultant la documentation de l’API. Vous pouvez également souvent trouver les valeurs de champ 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.
Gardez à l’esprit que si votre requête échoue, l’API renvoie souvent tous les résultats (au lieu d’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 souhaiterez peut-être 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 d’eux, vous pouvez utiliser l’action Pour chaque.
- Si vous avez besoin d’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 avec 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 de catalogue, qui correspond à une liste de catalogues. Vous pouvez utiliser cette variable à la fois dans les conditions et dans les actions. Par exemple, vous pouvez envoyer la liste de catalogues dans une action Envoyer un e-mail interne similaire à celle-ci :
{% for single_catalog in getCatalogData %}
* {{ single_catalog.title }}
{% 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 précisée plutôt qu’à la suite d’un événement. Étant donné qu’aucun événement spécifique de votre boutique ou d’une application ne lance le flux de travail, aucune donnée n’est incluse automatiquement.
Référence de l’API
Pour plus d’informations sur l’API utilisée dans cette action, consultez la requête de catalogues.