Obtenir les données des groupes de forfaits de vente
Dans les flux de travail exigeant les données des groupes de forfaits de vente, vous pouvez utiliser l’action Get selling plan group data (Obtenir les données des groupes de forfaits de vente) pour récupérer les informations des commandes de votre boutique.
Sur cette page
Configuration
Champs
L’action Get selling plan group data (Obtenir les données des groupes de forfaits de vente) 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 permettant d’obtenir les groupes de forfaits de vente qui ont été mis à jour au cours du jour précédent :
name='Subscribe & Save'La variable category est un filtre disponible sur la requête des groupes de forfaits de vente. Vous pouvez l’utiliser pour sélectionner des catégories spécifiques de groupes de forfaits de vente.
Lorsque vous requerrez des données, il est utile de connaître ce qui suit :
- Liste des filtres de groupes de forfaits de vente disponibles - Les requêtes doivent suivre une certaine syntaxe
- Les noms de champs pour toutes les requêtes se trouvent dans les documents des développeurs pour l’objet QueryRoot.
- 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 dans les étapes qui suivent cette action, utilisez la variable appelée Get selling plan group data (Obtenir les données des groupes de forfaits de vente), qui est une liste des groupes de forfaits de vente.Vous pouvez utiliser cette variable à la fois dans les conditions et dans les actions. Par exemple, vous pouvez envoyer la liste des groupes de forfaits de vente dans une action Envoyer un e-mail interne comme ceci :
{% for getSellingPlanGroupData_item in getSellingPlanGroupData %}
{{getSellingPlanGroupData_item.name}}
{% endfor %}Exemple
Par exemple, l’exécution d’un flux de travail est programmée pour avoir lieu tous les dimanches à 9 heures. L’action Get selling plan group data (Obtenir les données des groupes de forfaits de vente) est utilisée pour collecter les données des groupes de forfaits de vente créés au cours de la semaine précédente. Si les produits associés aux groupes de forfaits de vente sont vos best-sellers, la position du groupe de forfaits de vente peut augmenter.