API Shopify : les nouveautés de la version de janvier 2022

Nouveautés de l'API Shopify

Dans cet article, nous allons passer en revue les nouvelles fonctionnalités de l’API que nous venons de lancer en ce mois de janvier 2022. Vous découvrirez ainsi comment ces nouveautés vous aideront à améliorer la qualité de vos applications et votre expérience de développement.

Cette version inclut un filtrage amélioré des produits via l'API Storefront, la toute nouvelle API de taxonomie des produits et de nouvelles définitions de champs méta sur les collections, les clients et les commandes. Elle intègre également une API de facturation des commandes, de nouveaux codes d'erreur pour les mutations en bloc et des méthodes simplifiées pour obtenir les ressources à traduire, les images vedettes et les codes-barres.

Le lancement de cette nouvelle version coïncide avec la suppression de la version 2021-01. Assurez-vous donc de consulter votre rapport de santé (ou health report) des API pour vérifier que vos boutiques sont compatibles et n'oubliez pas de consulter les changements à venir. Pour connaître la liste complète des changements d’API associés à cette version, consultez les notes de la version 2022-01.

1. Filtrage de produits dans les collections avec l'API Storefront

Avec cette version 2022-01, il est désormais possible de filtrer les produits dans une collection, ce qui vous permet de limiter les résultats de recherche présentés aux clients. Après avoir récupéré les produits en fonction de la collection à laquelle ils appartiennent, vous pouvez les filtrer par fournisseur, type de produit, options de variantes, prix et disponibilité.

Ces filtres peuvent même être combinés, pour récupérer des produits dans une collection selon un ensemble spécifique de caractéristiques plus complexes.

Par exemple, la requête suivante montre comment extraire des produits avec toutes les caractéristiques suivantes :

  • Type : Shirts & Tops (Chemises et hauts)
  • Fournisseur : Bestshop
  • Couleur : Very Peri

Variables :

Le filtrage des produits d'une collection est un excellent moyen de présenter les produits les plus pertinents aux clients. Pour en savoir plus sur le filtrage des produits d'une collection avec l'API Storefront, consultez notre documentation.

2. API de taxonomie des produits

La nouvelle API de taxonomie des produits est parfaite pour organiser les produits et s’assurer que les clients peuvent les trouver sur les boutiques en ligne des marchands. Les objets StandardizedProductType sont des catégories prédéfinies de produits qui peuvent améliorer la visibilité et la recherche de produits sur une boutique. Ils permettent aussi aux marchands de mettre en vente plus facilement leurs produits sur des canaux tels que Facebook, qui exigent que les produits s'intègrent dans un ensemble de types standard.

Pour les types de produits qui ne correspondent pas à l'une des catégories prédéfinies, vous pouvez utiliser le champ customProductType de l'objet Product. Ces types de produits personnalisés sont des chaînes, comme l’ancien champ type. Ils peuvent être associés à un objet parent StandardizedProductType, si une catégorie parent correspond au produit.

Voici un exemple de requête permettant d'extraire la valeur StandardizedProductType d'un produit donné :
Réponse :
Pour en savoir plus sur la taxonomie des produits, consultez notre documentation pour les développeurs.

3. Définitions de champs méta sur les collections, les clients et les commandes

Dans la version de juillet 2021, nous avons publié des mises à jour des champs méta qui autorisaient des types de champ méta personnalisés pour les produits. La nouvelle version étend cette fonctionnalité aux collections, clients et commandes. Les champs méta de ces nouvelles ressources peuvent également effectuer des validations sur 18 types de données différents, ce qui vous permet de stocker des données validées pour les afficher dans des boutiques en ligne ou des applications.

Vous trouverez ci-dessous un exemple de requête permettant de créer une définition de champ méta client, qui enregistre une référence à un produit.
Variables :

Pour en savoir plus sur les définitions de champs méta et la migration vers le système de types amélioré, consultez notre documentation pour les développeurs.

4. API de facturation de commande

La nouvelle mutation orderInvoiceSend ajoutée aux applications permet d’envoyer des factures pour les commandes via l'API de Shopify. Fournissez une référence de commande et le contenu d'un e-mail, et un e-mail est envoyé directement au client pour demander le paiement d'une commande en attente. C'est un excellent moyen d'automatiser ce processus jusqu’alors effectué manuellement par les marchands.

Voici un exemple de mutation permettant d'envoyer une facture au client : Variables :


Et voici l'e-mail que cette requête enverra au client :

Exemple d'e-mail


Cet e-mail sera directement lié au processus de paiement, afin que le client puisse facilement régler sa commande.

Consultez notre documentation de référence pour en savoir plus sur l'envoi de factures avec la mutation orderInvoiceSend.

5. Codes d'erreur API des mutations en bloc

Auparavant, le seul code d'erreur que les mutations en bloc pouvaient afficher était « BULK_MUTATION_USER_ERROR_CODE ». Dans cette version, nous avons remplacé ce code d'erreur global par cinq nouveaux codes d'erreur plus précis, qui fournissent plus d'informations sur ce qui s'est passé.

Pour obtenir la liste complète des nouveaux codes d'erreur, consultez notre documentation pour les développeurs.

Pour rappel, si vous devez effectuer plus de 10 secondes de requêtes API continues, l’API de mutations en bloc BulkMutation est le moyen le plus rapide et le plus efficace de synchroniser les données vers Shopify. Pour en savoir plus sur la synchronisation des données avec Shopify grâce à l'API BulkMutation, consultez notre documentation.

6. Extraction de ressources à traduire par identifiant

Dans les versions passées, l'obtention des ressources à traduire pour un ensemble spécifique d'identifiants nécessitait de faire plusieurs requêtes, en récupérant une seule ressource à la fois. À partir de cette version 2022-01, il est possible d'obtenir une liste spécifique de ressources à traduire à l'aide d'un tableau d'identifiants, plutôt que d'obtenir toutes les ressources appartenant à un type spécifique ou de faire une requête distincte pour chaque identifiant.

Voici un exemple de récupération du contenu à traduire d'un produit spécifique et de deux variantes en une seule requête :
Pour en savoir plus sur la requête translatableResourcesByIds, consultez notre documentation de référence.

7. Nouveaux champs de produit de l’API Storefront

Depuis la version 2022-01, l'API Storefront prend en charge deux nouveaux champs pour les produits. Le champ featuredImage vous permet d'extraire rapidement et efficacement l'image vedette d'un produit, et le champ barcode d’une variante de produit vous permet d'extraire le code-barres de n'importe quelle variante.

Voici un exemple de requête qui extrait les deux nouveaux champs :

Réponse :

Restez au courant de toutes les nouveautés

Pour connaître toutes les nouveautés de la plateforme Shopify, abonnez-vous au journal des changements pour les développeurs Shopify, la principale source d’information pour tous les nouveaux lancements de produits. Utilisez régulièrement ce journal et restez à la pointe en utilisant toutes les nouvelles fonctionnalités dès leur sortie dans la prochaine version d’API candidate, 2022-04.

Rejoignez le programme des partenaires de Shopify

Inscrivez-vous gratuitement au programme partenaire de Shopify. Accédez à des outils et ressources pour aider les marchands Shopify à développer leur activité et faites partie d’un écosystème riche en opportunités.

Devenir partenaire Shopify

Which method is right for you?Publié par Maud Leuenberger. Maud est la rédactrice en chef du blog français de Shopify.

Texte original par Shayne Parmelee. Traduction par Solenn Marchand.
Image : Burst.

Développez votre activité avec le Programme Partenaires Shopify

En savoir plus