Récupérer les données du groupe de forfaits de vente

Dans les flux de travail qui nécessitent des données sur les groupes de forfaits de vente, vous pouvez utiliser l’action Récupérer les données du groupe de forfaits de vente pour récupérer les informations sur les commandes de votre boutique.

Configuration

Champs

L’action Récupérer les données du groupe de forfaits de vente contient les champs suivants, qui sont utilisés pour créer la requête :

Chaîne de requête

Voici un exemple de requête pour obtenir les groupes de forfaits de vente qui ont été mis à jour au cours du dernier jour :

name='Subscribe & Save'

La variable category est un filtre disponible sur la requête de groupe de forfaits de vente et peut être utilisée pour sélectionner des catégories spécifiques de groupes de forfaits de vente.

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

• Liste des filtres de groupes de forfaits de vente 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. Autrement, vous pouvez souvent 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 en utilisant 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 Récupérer les 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 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 produire la liste en sortie, par exemple pour envoyer un e-mail contenant tous les articles, vous pouvez utiliser les données renvoyées directement dans les actions ultérieures.

Pour accéder aux données renvoyées dans les étapes qui suivent cette action, utilisez la variable nommée Get selling plan group data, qui est une liste de groupes de forfaits de vente. Vous pouvez utiliser cette variable dans les conditions et les actions. Par exemple, vous pouvez envoyer la liste des groupes de forfaits de vente dans une action Envoyer un e-mail interne comme suit :

{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
  {{getSellingPlanGroupData_item.name}}
{% endfor %}

Exemple

Par exemple, un flux de travail est programmé pour s’exécuter tous les dimanches à 9 h 00. L’action Récupérer les données du groupe de forfaits de vente est utilisée pour recueillir des données sur les groupes de forfaits de vente créés au cours de la dernière semaine. Si les produits associés aux groupes de forfaits de vente sont vos articles les plus vendus, la position du groupe de forfaits de vente peut alors augmenter.

Référence d’API

• Ressource de groupe de forfaits de vente
• Filtres de requête de groupe de forfaits de vente