Créer des QR codes dynamiques depuis Google Sheets avec Apps Script

2026-10-12 · Mis à jour 2026-10-26 api developers google-sheets automation

Pour créer des QR codes dynamiques depuis une feuille Google Sheets, mettez un lien par ligne avec votre propre identifiant de référence, collez un court Apps Script dans la feuille, enregistrez votre jeton d'API dans les propriétés du script et lancez-le depuis un menu. Le script envoie les lignes à l'API REST de QR Maker par lots de 100 et réécrit le lien court de chaque ligne dans la feuille. Le relancer ne remplit que les lignes encore vides : il ne crée donc jamais de doublons.

Quand c'est le bon outil

C'est dans un tableur que vivent déjà la plupart des listes de produits, des plans de table et des suivis de campagne. Si quelqu'un de votre équipe tient cette liste à la main, créer les codes depuis la même feuille garde la liste et les codes synchronisés sans faire appel à un développeur. Les cas typiques : un code par SKU pour l'emballage, un code par table ou par chambre, ou un code par commercial ou par point de vente pour une même campagne.

Si vous avez besoin des codes dans votre propre application, appelez plutôt l'API depuis votre serveur. Le guide de l'API REST explique comment faire.

Ce qu'il vous faut

Une offre Business QR Maker et un jeton d'API. Créez le jeton dans Réglages, Jetons API. Il commence par qrs_ et n'est affiché qu'une fois.
Une feuille Google Sheets avec un en-tête en ligne 1 et ces colonnes : A external_id, B target_url, C name (facultatif), D short_link (laisser vide), E status (laisser vide).

L'external_id est votre propre référence pour la ligne : un SKU, un numéro de table, un code commercial. Il doit être unique dans votre compte et peut contenir des lettres, des chiffres, des points, des tirets bas, des deux-points et des tirets.

Étape 1 : ajouter le script

Ouvrez la feuille, choisissez Extensions puis Apps Script, supprimez le code d'exemple et collez le contenu de google-sheets.gs. Enregistrez le projet.

Étape 2 : stocker le jeton en sécurité

Dans l'éditeur Apps Script, ouvrez Paramètres du projet (Project Settings), descendez jusqu'à Propriétés du script (Script properties) et ajoutez une propriété nommée QR_TOKEN avec votre jeton comme valeur.

Ne collez pas le jeton dans une cellule. Toute personne qui peut ouvrir la feuille peut lire ses cellules, et quiconque détient le jeton peut créer, modifier et supprimer des codes dans votre compte. Les propriétés du script ne sont visibles que par les personnes qui peuvent modifier le script.

Étape 3 : le lancer

Rechargez la feuille. Un nouveau menu QR Maker apparaît. Choisissez « Create codes for new rows » (créer les codes des nouvelles lignes). La première fois, Google vous demande d'autoriser le script à modifier la feuille et à appeler un service externe.

Pour chaque ligne qui a un identifiant et un lien mais pas encore de lien court, le script crée un code dynamique et remplit la colonne D. La colonne E affiche created, ou already existed si un code avec cet identifiant a déjà été créé, ou un code d'erreur si la ligne a été refusée : INVALID_TARGET_URL pour un lien qui n'est pas une adresse http ou https valide, ou un code commençant par URL_BLOCKED_ quand les contrôles de sécurité refusent la destination, par exemple un lien vers un autre raccourcisseur d'URL.

Étape 4 : récupérer les images

Le lien court de la colonne D est ce que doit encoder le code imprimé. Pour l'image elle-même, vous avez deux options :

Télécharger chaque code en SVG depuis votre tableau de bord QR Maker, où vous pouvez aussi appliquer vos couleurs et votre logo.
Le récupérer via l'API avec GET /v1/qrcodes/by-external-id/{external_id}?include=svg, qui renvoie le code avec le texte SVG dans data.svg. L'exemple Python enregistre un SVG par ligne et constitue la voie la plus rapide pour des centaines de codes.

Changer une destination plus tard

Modifier la colonne B et relancer le script ne déplace pas un code existant. C'est voulu : un POST avec un identifiant connu et un lien différent renvoie un conflit au lieu de rediriger en silence un code peut-être déjà imprimé. Changez la destination dans le tableau de bord, ou appelez PATCH /v1/qrcodes/by-external-id/{external_id} avec le nouveau target_url.

Limites à garder en tête

Chaque exécution envoie jusqu'à 100 lignes par requête, et chaque ligne réussie compte comme un appel sur les 50 000 mensuels inclus dans l'offre Business. Les lignes en échec ne comptent pas. Apps Script s'arrête lui-même au bout d'environ six minutes par exécution, ce qui suffit pour plusieurs milliers de lignes ; au-delà, relancez-le et il reprendra là où il s'est arrêté.

FAQ

Faut-il un serveur pour cela ?

Non. Apps Script s'exécute sur les serveurs de Google, le jeton n'atteint donc jamais un navigateur. C'est aussi pourquoi cela fonctionne alors que l'API n'accepte pas les appels depuis des pages web.

Les collègues en lecture seule peuvent-ils voir mon jeton ?

Non. Les propriétés du script ne sont visibles que par les personnes qui peuvent modifier le projet de script. Les lecteurs et les commentateurs ne peuvent pas les ouvrir.

Que se passe-t-il si je supprime une ligne ?

Rien n'arrive au code. Supprimer une ligne la retire seulement de la feuille. Désactivez ou supprimez le code dans le tableau de bord, ou via l'API, s'il doit cesser de fonctionner.