1. Livres & vidéos
  2. Google Apps Script
  3. Types de scripts
Extrait - Google Apps Script Créez vos outils pour automatiser Google Workspace
Extraits du livre
Google Apps Script Créez vos outils pour automatiser Google Workspace Revenir à la page d'achat du livre

Types de scripts

Introduction

Nous avons abordé les différentes manières d’accéder à l’éditeur dans le chapitre précédent. La création d’un projet Apps Script s’opère lorsque vous accédez à l’éditeur et commencez à rédiger du code ou à renommer un fichier.

Il existe deux types de projets Apps Script distincts : les projets autonomes, créés directement via script.google.com ou en saisissant "script.new", et les projets liés à un document spécifique. Le contexte d’un projet varie selon sa méthode de création, ce qui influence directement son comportement. Voyons cela plus en détail.

Scripts liés aux documents Google Workspace

Les scripts liés (container-bound scripts) sont les projets créés directement depuis un fichier Google Workspace (Sheets, Docs, Slides ou Forms).

Ils sont littéralement « attachés » au fichier dans lequel vous les créez. Ils ne sont pas visibles dans votre Drive, mais ils apparaissent dans la console Apps Script avec l’icône du fichier qui les contient, et un lien permet d’accéder rapidement au conteneur.

images/03RI01.png

Si vous partagez le conteneur, vous partagez le script. Si vous créez une copie du conteneur, vous copiez également le script !

Les scripts liés fonctionnent comme des extensions intégrées à leur application hôte. Grâce à cette relation directe, ils bénéficient d’un accès privilégié aux contenus et propriétés du document (qu’il s’agisse d’un Sheets, d’un Form ou d’un Slides), via des méthodes spécifiques proposées par Apps Script.

Ils permettent également d’ajouter des fonctionnalités sur mesure, comme des menus personnalisés ou des boîtes de dialogue, et de tirer parti de déclencheurs propres à chaque type d’application. Par exemple, un script associé à un Google Forms peut réagir automatiquement...

Scripts autonomes

Un script autonome est un projet Apps Script qui ne dépend pas d’un document Google spécifique. Il fonctionne comme un document Google classique dans Google Drive, ce qui permet, entre autres, de gérer ses autorisations d’accès de la même manière.

Ces projets-là sont ceux créés depuis script.google.com ou Drive directement. Ils apparaissent avec l’icône script dans la console Apps Script.

images/03RI02.png

Conteneur vs. projet indépendant

Voici un résumé simple des différences entre les deux types de projets Apps Script :

Script lié (conteneur)

  • Associé à un fichier unique.

  • Idéal pour automatiser ou enrichir ce fichier spécifique grâce à des méthodes dédiées.

  • Les déclencheurs sont spécifiques au contexte du fichier.

  • Se copie automatiquement avec le document hôte.

  • Partage les droits d’accès de son hôte.

Script autonome (indépendant)

  • Existe indépendamment dans Google Drive.

  • Ses droits sont gérés comme tout autre fichier Google.

  • Peut interagir avec plusieurs fichiers et fonctionner comme une application centralisée.

En abordant Apps Script, il est naturel de se demander quel type de projet correspond le mieux à vos besoins. Ce livre, en explorant divers cas d’usage, vous aidera à y voir plus clair. Pour commencer, voici une manière d’envisager les choses :

Conteneur = pratique et local (utile pour automatiser au sein d’un seul document). 

Autonome = puissant et global (utile pour plusieurs documents ou pour créer des webapp).