Récupérer les données des cartes-cadeaux

Dans les flux de travail qui nécessitent des données sur les cartes-cadeaux, vous pouvez utiliser l’action Récupérer les données des cartes-cadeaux pour récupérer les informations sur les cartes-cadeaux de votre boutique.

Il est important de noter que votre boutique possède à la fois des produits de type carte-cadeau, qui sont utilisés pour générer des cartes-cadeaux, et les cartes-cadeaux elles-mêmes, que les clients peuvent utiliser pour effectuer des achats. L’action Récupérer les données des cartes-cadeaux récupère les informations sur les cartes-cadeaux elles-mêmes. Pour obtenir des informations sur les produits de type carte-cadeau, utilisez les actions Récupérer les données sur les produits ou Récupérer les données sur les variantes de produit.

Sur cette page

Configuration

Champs

L’action Récupérer les données des cartes-cadeaux contient les champs suivants, qui sont utilisés pour élaborer la requête :

Champs utilisés dans les actions Récupérer les données.
Champ	Description
Trier les données par	Obligatoire. Les paramètres par lesquels les données renvoyées par la requête de recherche sont triées.
Nombre maximal de résultats	Obligatoire. Le nombre maximal 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 cartes-cadeaux qui ont été mises à jour au cours du dernier jour :

created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variable created_at est un filtre disponible sur la requête de cartes-cadeaux et peut être utilisée plusieurs fois ou combinée à d’autres variables. La variable Liquid scheduledAt est disponible pour les flux de travail qui ont utilisé le déclencheur Heure planifié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 cartes-cadeaux 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 aussi souvent trouver les valeurs des champs 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 votre interface administrateur, puis vérifiez l’URL.
Vous pouvez exécuter ou tester une requête dans votre boutique en utilisant l’appli Shopify GraphiQL.
Gardez à l’esprit ce qui se passe si votre requête échoue. Souvent, l’API renverra 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 pouvez utiliser ces données de plusieurs 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 utiliser la liste entière, par exemple pour envoyer un e-mail contenant 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 nommée Obtenir les données de la carte-cadeau, qui est une liste de cartes-cadeaux. Vous pouvez utiliser cette variable dans des conditions et des actions. Par exemple, vous pouvez envoyer la liste de cartes-cadeaux dans une action Envoyer un e-mail interne comme ceci :

{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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. Puisqu’aucun événement spécifique dans votre boutique ou provenant d’une appli ne démarre le flux de travail, aucune donnée n’est automatiquement incluse.