Dans cet article, nous allons passer en revue les nouvelles fonctionnalités de l’API que nous venons de lancer en ce mois d’octobre 2020. Vous découvrirez ainsi comment ces nouveautés vous aideront à améliorer la qualité de vos applications et votre expérience de développement.
Et ce mois-ci, notre API contient beaucoup de nouveautés : des sommes de contrôle (ou checksums ) des ressources, des améliorations pour la gestion des réductions, des API de gestion des politiques et mentions légales, et le statut de produits provisoires. Le lancement de cette nouvelle API 2020-10 coïncide également avec la suppression de la version 2019-10. Assurez-vous donc de consulter votre rapport de santé (ou health report) des API pour vérifier que vos boutiques sont compatibles.
Sommaire
Les nouveautés de la version 2020-10
Voici les nouvelles fonctionnalités de la version d’API 2020-10.
1. Les sommes de contrôle des ressources
Avant, la synchronisation des fichiers locaux de thème avec une boutique en ligne présentait certaines difficultés. Sans outil de programmation pour identifier les fichiers locaux qui sont différents de la version en ligne, la seule possibilité était de mettre à jour l’ensemble des fichiers locaux. Mais la nouvelle version d’API 2020-10 permet d’utiliser des sommes de contrôle (ou checksums) pour les fichiers de thème, ce qui permet de synchroniser seulement les fichiers modifiés et de n’effectuer que les requêtes nécessaires.
Dans les versions précédentes du Shopify Theme Kit, vous deviez charger tous les fichiers dans votre boutique en ligne. Pour les thèmes les plus lourds, cela pouvait prendre jusqu’à plusieurs minutes. Mais grâce aux sommes de contrôle (ou checksums) introduites dans la version 2020-10 de l’API de gestion des ressources, vous réduisez le temps de chargement des fichiers à quelques secondes seulement.
Voici un tableau qui montre comment les sommes de contrôle (ou checksums) agissent sur le chargement des thèmes en fonction du nombre de fichiers, après que 10 fichiers ont été modifiés :
Consultez notre documentation pour en savoir plus sur les sommes de contrôle (ou checksums).
Créez des applications pour les marchands Shopify
Que vous vouliez développer des applications pour l’App Store de Shopify, offrir des services de développement d’applications personnalisées, ou trouver de nouveaux utilisateurs pour votre application, le programme de partenaires Shopify est votre meilleur allié. Rejoignez le programme gratuitement et accédez à des ressources de formation, des environnements de prévisualisation pour les développeurs, et de nombreuses possibilités de toucher un revenu pour votre contribution !
S’inscrire2. Les améliorations pour la gestion des réductions
Cette nouvelle version comprend de nouveaux champs, de nouvelles modifications possibles, de nouveaux arguments et types de réductions pour étendre et améliorer leur utilité. Par l’intermédiaire de l’API administrateur GraphQL, vous pouvez désormais obtenir le nombre d’utilisations des réductions automatiques, chercher parmi les différentes réductions, et même faire des modifications groupées, ce qui réduit de façon significative le nombre d’appels d’API nécessaires pour gérer les réductions.
Par exemple, jusqu’à présent, si vous vouliez supprimer 10 codes de réduction, vous deviez exécuter 10 modifications, une pour chaque ID de réduction. Même si vous pouviez lancer toutes ces modifications en une seule et même opération, elles représentaient un poids important dans la limite d’appels d’API imposée par Shopify.
Désormais, vous pouvez supprimer les 10 codes de réduction en une seule et même requête :
Une requête groupée vous permet d’activer, de désactiver, ou de supprimer plusieurs codes de réduction simples ou automatiques en une seule requête. Les requêtes groupées réduisent le nombre total de requêtes nécessaires pour gérer un grand nombre de codes de réduction par ordre de grandeur, ce qui vous laisse davantage d’appels d’API pour d’autres fonctions essentielles.
Parcourez notre documentation destinée aux développeurs pour en savoir plus sur la gestion groupée de vos réductions.
3. L'ajout des réductions sur des articles en éditant des commandes
En éditant des commandes depuis l’API administrateur GraphQL, vous pouvez maintenant inclure des réductions manuelles ou sous forme de pourcentage sur n’importe quel article. L’ajout de réduction pendant l’édition de commandes existantes est une toute nouvelle fonctionnalité et est disponible exclusivement sur GraphQL.
Voici un exemple de modification permettant d’ajouter une réduction à un article pendant l’édition d’une commande.
Parcourez notre documentation pour voir plus d’exemples de modifications et d’ajouts d’instructions sur des commandes existantes.
4. L'API de gestion des politiques et mentions légales
Au cours des dernières années, les États du monde entier ont fixé de nombreuses règles et recommandations juridiques afin de protéger les propriétaires de boutiques en ligne ainsi que leurs clients et leurs partenaires. Ces exigences doivent souvent apparaître dans les conditions d’utilisation, la politique de confidentialité ou la politique de remboursement d’une boutique.
Dans les versions précédentes, ces informations juridiques ne pouvaient être modifiées que depuis la page de paramètres de l’interface administrateur de Shopify. Dans la version 2020-10, ces informations juridiques sont maintenant accessibles depuis l’API administrateur GraphQL, ce qui permet à des applications d’aider les marchands à gérer tous les aspects de leurs obligations relatives aux informations juridiques.
La requête ci-dessous pour shopPolicies affichera le type et le contenu des politiques de la boutique :
En ajoutant une modification, vous pourrez modifier ces informations juridiques, ce qui peut être particulièrement utile si vous voulez aider les marchands à respecter la réglementation en vigueur dans certaines régions. Consultez notre documentation destinée aux développeurs pour en savoir plus sur la modification shopPolicyUpdate.
5. Les produits provisoires
Dans la version 2020-10, vous pouvez désormais indiquer le statut des produits dans les API de produit GraphQL et REST. Ce champ permet d’identifier, de trier et de gérer les produits en fonction de leurs statuts : provisoire, actif, ou archivé.
Vous pouvez créer des produits et indiquer leur statut provisoire, travailler sur eux par étapes, puis les rendre disponibles sur les canaux de vente appropriés avec le statut « actif » lorsqu’ils sont terminés. L’archivage de produits est un bon moyen de conserver une liste de produits organisée et claire sans s’inquiéter de perdre des informations concernant un produit.
Voici un exemple de requête permettant d’aller chercher des produits « provisoires ».
Pour plus d’informations sur le statut des produits, ainsi que sur les modifications du statut d’un produit à actif, archivé, ou provisoire, parcourez notre guide sur l’utilisation des statuts pour identifier, trier et gérer des produits.
Restez au courant de toutes les nouveautés
Pour connaitre 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 leurs sorties dans la prochaine version d’API candidate 2021-01.
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
Publié par Maud Leuenberger. Maud est la rédactrice en chef du blog français de Shopify.
Texte original par Shayne Parmelee. Traduction par Nicolas Bruno.
Image : Burst.