Scripts liés au conteneur

Un script est lié à un fichier Google Sheets, Docs, Slides ou Forms s'il était créé à partir de ce document plutôt qu'en tant que script autonome. Le fichier auquel un script lié est joint est appelé un "conteneur". Les scripts liés se comportent généralement comme des scripts autonomes, à la différence qu'ils n'apparaissent pas dans Google Drive, ils ne peuvent pas être dissociés du fichier auquel ils sont liés et qui obtiennent quelques privilèges spéciaux sur le fichier parent.

Notez que les scripts peuvent également être liés à Google Sites, mais qu'ils sont sont presque toujours déployées sous forme d'applications Web. Scripts liées à Google Sheets, Docs, Slides ou Forms peuvent également devenir des applications Web, même si ce qui n'est pas courant.

Remarque :La publication des scripts liés est annulée. des modules complémentaires qui ne fonctionnent que au fichier auquel ils sont liés.

Créer un script lié

Google Docs, Sheets ou Slides

Pour créer un script lié dans Google Docs, Sheets ou Slides, ouvrez un document dans Docs, une feuille de calcul dans Sheets ou une présentation dans Slides, puis cliquez sur Extensions > Apps Script. Pour rouvrir le script dans à l'avenir, faites la même chose ou ouvrez le script à partir de Tableau de bord Apps Script

Google Forms

Pour créer un script lié dans Google Forms, ouvrez un formulaire et cliquez sur Plus > Script éditeur. Pour rouvrir le script dans le fichier faire la même chose ou ouvrir le script à partir du Tableau de bord Apps Script

Remarque :L'outil clasp ne peut pas créer de scripts liés. mais il peut les cloner et les modifier.

Méthodes spéciales

Les scripts liés peuvent appeler des méthodes que les scripts autonomes ne peuvent pas:

• getActiveSpreadsheet(), getActiveDocument(), getActivePresentation() et getActiveForm() permettent aux scripts liés de faire référence à leur fichier parent sans faire référence au l'ID du fichier.
• getUi permet des scripts liés accèdent à l'interface utilisateur pour leur fichier parent afin d'ajouter les menus, les boîtes de dialogue et les barres latérales personnalisés.
• Dans Google Sheets, getActiveSheet(), getActiveRange(), et getActiveCell() laissez le script déterminer la feuille actuelle de l'utilisateur, la plage de cellules sélectionnée ou la cellule individuelle sélectionnée. setActiveSheet(sheet) et setActiveRange(range) laissez le script modifier ces sélections.
• Dans Google Docs, getCursor() et getSelection() laissez le script déterminer la position du curseur de l'utilisateur ou du texte sélectionné. setCursor(position) et setSelection(range) laissez le script changer ces emplacements.

Pour en savoir plus, consultez les guide pour développer Google Sheets ou le guide sur les fonctionnalités avancées de Google Docs.

Remarque :Ces méthodes ne sont disponibles que pour les scripts liés exécutés à partir de l'éditeur de script, les éléments de menu, les boîtes de dialogue, les barres latérales ou les déclencheurs. Lorsqu'une liaison est exécuté en tant qu'application Web ou via le API Apps Script, ces méthodes ne sont pas disponibles.

Menus, boîtes de dialogue et barres latérales personnalisés

Les scripts liés peuvent personnaliser Google Sheets, Docs et Forms en ajoutant des menus personnalisés et boîtes de dialogue ou barres latérales. Gardez à l'esprit que Toutefois, un script ne peut interagir qu'avec l'interface utilisateur l'instance actuelle d'un fichier ouvert. Autrement dit, un script lié à un document n'affecte pas l'interface utilisateur d'un autre document.

Les modules complémentaires peuvent également ajouter des menus, des boîtes de dialogue et des barres latérales personnalisés. Il est recommandé de développer des modules complémentaires scripts autonomes.

Modules complémentaires

Les modules complémentaires s'exécutent dans Gmail, Google Sheets, Docs, Slides et Forms. Si vous avez développé une limite ou autonome et que vous souhaitez le partager avec le monde entier, Apps Script vous permet publiez votre script en tant que afin que d'autres utilisateurs puissent l'installer depuis la boutique de modules complémentaires.

Déclencheurs

Les scripts liés peuvent utiliser des déclencheurs simples comme la fonction spéciale onOpen(), qui s'exécute automatiquement chaque fois qu'un fichier est ouvert par un utilisateur autorisé à le modifier. Comme tous les types de scripts, ils peuvent utilisez également des déclencheurs installables.

Fonctions personnalisées

Une fonction personnalisée est une fonction lié à Google Sheets et que vous appelez directement à partir d'une cellule à l'aide de la méthode =myFunctionName(). Les fonctions personnalisées sont donc similaires aux centaines fonctions intégrées dans Sheets comme AVERAGE ou SUM, sauf que vous définissez le comportement de la fonction personnalisée.

Accès aux scripts liés

Seuls les utilisateurs autorisés à modifier un conteneur peuvent exécuter le script qui lui est lié. Les collaborateurs disposant uniquement d'un accès en lecture ne peuvent pas ouvrir le script. éditeur, même s'il crée une copie du fichier conteneur, il devient propriétaire de la copie et peut voir et exécuter une copie du script.

Pour savoir comment partager le fichier de conteneur d'un script, consultez Partager des fichiers à partir de Google Drive

Tous les scripts liés à un conteneur utilisent les mêmes propriétés définie pour le fichier du conteneur. Le propriétaire du conteneur propriétaire d'un nouveau projet de script, quelle que soit la personne qui l'a créé.