Envoyer une requête de l’API de l’interface administrateur

L’action Envoyer une requête de l’API de l’interface administrateur envoie une mutation à l’API Admin GraphQL Shopify. Cette action vous permet d’effectuer presque toutes les actions autorisées par l’API à l’aide de Flow.

Champs

L’action Envoyer une requête de l’API de l’interface administrateur contient les champs suivants.

Champs utilisés dans l’action Envoyer une requête de l’API de l’interface administrateur.

Champ	Description
Mutations	Obligatoire. La mutation Admin GraphQL Shopify que vous souhaitez appeler. Une mutation est une API qui effectue une action ou met à jour des données.
Entrées de mutation	Obligatoire. Les données (dans JSON) que vous devez envoyer dans le cadre de votre requête de mutation. Chaque mutation nécessite un ensemble de données différent, qui est documenté dans le lien fourni pour chaque mutation. Pour créer le JSON requis, vous pouvez utiliser Liquid ou l’action Exécuter le code.

Déclencheurs

L’action Envoyer une requête de l’API de l’interface administrateur peut être utilisée dans n’importe quel flux de travail, avec n’importe quel déclencheur, tant que le flux de travail fournit les données nécessaires à la construction des entrées de mutation.

Exemples

Exemple 1 : mettre à jour le modèle utilisé pour un produit

Dans cet exemple, nous utiliserons l’action Envoyer une requête de l’API de l’interface administrateur pour appeler la mutation productUpdate afin de mettre à jour le modèle utilisé pour un produit.

Le champ id est requis et doit être un GID de produit valide. Ici, nous le configurons avec la variable Liquid {{product.id}}. Cela suppose que votre flux de travail dispose d’un déclencheur qui fournit un objet produit.

Le templateSuffix est le nom du modèle que vous souhaitez appliquer au produit. Par exemple, si vous souhaitez appliquer le modèle pre-order, vous définissez le suffixe du modèle sur pre-order.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

Exemple 2 : mettre à jour le statut d’exonération fiscale d’un(e) client(e)

Dans cet exemple, nous utiliserons l’action Envoyer une requête de l’API de l’interface administrateur pour appeler la mutation customerUpdate afin de mettre à jour le statut d’exonération fiscale d’un(e) client(e).

Le id de l’adresse est obligatoire et doit être un GID client valide. Nous la définissez ici avec la variable Liquid {{order.customer.id}} faible. Cela suppose que votre flux de travail dispose d’un déclencheur qui fournit un objet de commande.

Le champ taxExempt est un booléen qui indique si le/la client(e) est exonéré(e) de taxe. Dans cet exemple, nous l’avons paramétré comme true.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

Exemple 3 : mettre à jour les paramètres régionaux d’un(e) client(e)

Dans cet exemple, nous utiliserons l’action Send Admin API request (Envoyer une requête de l’API de l’interface administrateur) pour appeler la mutation customerUpdate afin de mettre à jour les paramètres régionaux d’un client.

Le champ id est requis et doit être un GID de client valide. Ici, nous le configurons avec la variable Liquid {{customer.id}}. Cela suppose que votre flux de travail dispose d’un déclencheur qui fournit un objet client.

Le champ locale est une chaîne qui représente les paramètres régionaux du/de la client(e). Dans cet exemple, nous l’avons paramétré comme en.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Limitations

L’action Envoyer une requête de l’API de l’interface administrateur présente les limitations suivantes :

• L’action ne renvoie pas de données dans l’environnement Flow à la suite de la mutation.
• L’action ne prend pas en charge les requêtes GraphQL, mais uniquement les mutations.
• L’action ne prend pas en charge les mutations asynchrones ou les mutations qui renvoient un type Job.
• L’action ne prend pas en charge les mutations propres à certaines applications, telles que les abonnements et les réductions.
• L’action affichera une liste de Mutations et Mutation inputs à partir d’une seule version de l’API Shopify, actuellement 2024-01.
• Lorsque la version d’API est mise à niveau et contient une modification importante, cette action peut échouer si vous dépendez de ce champ.