Commencez avec CLASP : Installation facile de Google Apps Script

Remarque : Cet article a été publié à l'origine dans notre forum communautaire.

Vous souhaitez donner un coup de fouet à votre développement Google Apps Script ? Voici CLASP-Command Line Apps Script, l'outil qui vous permet de rédiger et de gérer vos projets Google Apps Script localement sur votre ordinateur, avec la puissance du contrôle de version et des pratiques de développement modernes.

Dans ce guide rapide, nous vous expliquons les étapes à suivre pour mettre en place CLASP, afin que vous puissiez commencer à coder comme un pro en un rien de temps !

Étape 1 : Installer Node.js et NPM

Avant de pouvoir installer CLASP, vous devez avoir installé Node.js et NPM (Node Package Manager) sur votre machine.

1. Télécharger et installer Node.js

• Aller à la pageSite officiel de Node.jset téléchargez la dernière version stable de votre système d'exploitation.
• Suivez les instructions d'installation et assurez-vous que NPM est installé en même temps que Node.js. NPM est généralement fourni avec Node.js, vous devriez donc être prêt une fois l'installation terminée.

2. Vérifier l'installation

• Ouvrez votre interface de ligne de commande (CLI) et tapez les commandes suivantes pour vérifier si Node.js et NPM sont installés : bashnode -v npm -v

• Si l'installation est correcte, les deux commandes devraient renvoyer des numéros de version.

Étape 2 : Installer CLASP

Maintenant que Node.js et NPM sont installés, vous pouvez installer CLASP globalement sur votre machine.

1. Installer CLASP

• Dans votre CLI, tapez la commande suivante : bash npm install -g @google/clasp
• Cette commande installe CLASP globalement, ce qui vous permet de l'utiliser à partir de n'importe quel endroit de votre système.

2. Vérifier l'installation

• Pour confirmer que CLASP est correctement installé, exécutez la commande suivante : bash clasp -v
• Vous devriez voir le numéro de version de CLASP, ce qui indique que l'installation a réussi.

Étape 3 : Configuration du projet Google Apps Script

Maintenant que CLASP est installé, vous pouvez configurer votre projet Google Apps Script.

1. Authentifiez CLASP avec votre compte Google

• Exécutez la commande suivante pour vous connecter avec votre compte Google : bash clasp login
• Une fenêtre de navigateur s'ouvre et vous demande d'authentifier CLASP avec votre compte Google. Suivez les instructions pour autoriser l'accès.

2. Créer un nouveau projet Google Apps Script

• Pour créer un nouveau projet, naviguez vers le répertoire de votre choix dans l'interface de programmation et exécutez : bash clasp create -title “My New Project” -type standalone
• Remplacez “Mon nouveau projet” par le nom de votre projet. Le drapeau `-type standalone` indique qu'il s'agit d'un script autonome, qui n'est lié à aucun document, feuille de calcul ou formulaire Google en particulier.

3. Extraire un projet Google Apps Script existant (facultatif)

• Si vous avez déjà un projet Google Apps Script et que vous souhaitez travailler dessus localement, utilisez : bash clasp clone YOUR_SCRIPT_ID
• Remplacez `Votre_ID_SCRIPT` par l'ID du script de votre projet. Cela permet d'extraire le projet de votre machine locale.

Étape 4 : Commencer à coder et à apporter des modifications

Une fois votre projet configuré, vous pouvez commencer à coder localement et à transférer vos modifications vers Google Apps Script.

1. Écrire votre code localement

• Utilisez votre éditeur de code préféré (comme VS Code) pour écrire votre code Apps Script. Les fichiers sont généralement enregistrés en tant que fichiers `.gs` (Google Script) ou `.js` (JavaScript).

2. Transférer les modifications vers Google Apps Script

• Après avoir effectué des modifications localement, vous pouvez les transférer vers Google Apps Script en exécutant : bash clasp push
• Cette commande télécharge vos modifications locales dans l'éditeur de scripts de Google Apps.

3. Extraire les modifications du script Google Apps

• Si vous avez effectué des modifications directement dans l'éditeur Google Apps Script, transférez ces modifications dans votre environnement local à l'aide de la commande suivante : bash clasp pull
• Cela permet de s'assurer que les fichiers locaux sont à jour des dernières modifications.

Étape 5 : Déployer votre script

Une fois que vous êtes satisfait de votre script, vous pouvez le déployer directement à l'aide de CLASP.

1. Déployer en tant qu'application Web

• Pour déployer votre script en tant qu'application web, utilisez la commande suivante : bash clasp deploy -description “Initial deployment”
• Cela permet de déployer la dernière version de votre script et de vous donner une URL de déploiement.

2. Gérer les déploiements

• Pour afficher tous les déploiements ou mettre à jour un déploiement existant, utilisez : bash clasp deployments
• Cette commande affiche tous les déploiements actifs et leurs URL.

Conclusion

Avec CLASP, la gestion de vos projets Google Apps Script devient plus efficace et plus évolutive. Vous pouvez désormais tirer parti du contrôle des versions, des environnements de développement locaux et des processus de déploiement transparents. Que vous développiez un script complexe ou que vous débutiez, CLASP change la donne pour les développeurs d'Apps Script. Prêt à passer à la vitesse supérieure en matière de codage ? Installez CLASP dès aujourd'hui et commencez à explorer les possibilités infinies qu'il offre !