Blog de web design, développement web et affiliation

API Shopify : les nouveautés de la version 2020-10

API Shopify : les nouveautés de la version 2020-10

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.

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.

Shopify API release October 2020: deploying files without checksum
Le Theme Kit charge les fichiers du thème sans utiliser de sommes de contrôle (ou checksums). Le chargement de ce thème basique dure plus de 15 secondes.
Shopify API release October 2020: deploying with theme kit version 1.10+
La version 1.10+ du Theme Kit ne charge que les fichiers qui ont été modifiés depuis la dernière synchronisation, ce qui réduit considérablement le temps de chargement. Si vous avez modifié trois fichiers, le même thème sera mis à jour en moins d’une seconde.

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 :

Tableau checksums chargement des thèmes

Consultez notre documentation pour en savoir plus sur les sommes de contrôle (ou checksums).

2. 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

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 Nicolas Bruno.

Image : Burst.

Développez votre entreprise avec le programme Partenaires Shopify

En savoir plus