google-apps-script Tutoriel
Démarrer avec google-apps-script

Remarques

Installation ou configuration

Le script Google Apps ne nécessite ni installation ni configuration. La seule exigence est un compte Google. Un compte Gmail fonctionne aussi bien qu'un compte Google Apps for Work / Éducation / Gouvernement. Vous pouvez créer un nouveau compte Google en accédant à accounts.google.com

Commencez votre premier script en allant sur script.google.com . Vous pouvez également accéder à Google Apps Script sous les tools -> Script editor... de nombreuses applications Google, c.-à-d. Docs, Sheets, Forms, etc. Google Apps Script peut également être ajouté directement à votre Google Drive avec la fonctionnalité Connect more apps.. .

La documentation officielle est disponible sur developers.google.com/apps-script/ .

Pour que les scripts d'application s'exécutent, ils doivent contenir un fichier code.gs. Le fichier code.gs doit contenir une fonction nommée doGet (scripts autonomes) ou une fonction onOpen (scripts addon). Les démarrages rapides dans la documentation contiennent des exemples.

Si une API est activée dans le script d'application, elle doit également être activée dans la console du développeur. Cependant, la console des développeurs contient des API qui peuvent être activées mais n'apparaissent pas dans l'interface du script d'application. Par exemple, Marketplace SDK doit être activé dans la console des développeurs avant que l'application puisse être publiée sur Google Play Store ou sur un déploiement à l'échelle du domaine de la suite G.

Pour les applications Google pour l'éducation / le travail / le gouvernement, il existe des paramètres dans la console d'administration du domaine qui peuvent être ajustés pour autoriser ou interdire l'exécution de scripts d'application.

Types de scripts

Les scripts Google App sont de trois types.

• Autonome
• Lié à Google Apps
• Applications Web

Script autonome

Les scripts autonomes ne sont liés à aucune application Google, par exemple Docs, Sheets ou Forms, etc. Vous pouvez créer un script autonome en visitant script.google.com ou en connectant un script d'application Google à Google Drive. Le script autonome peut être utilisé pour programmer des applications Google indépendamment, peut être utilisé comme une application Web ou peut être configuré pour s'exécuter automatiquement à partir d'un déclencheur installable. Voir la documentation du script autonome.

Lié à Google Apps

Script lié à Google Apps, également appelé script lié à un conteneur; Contrairement aux scripts autonomes, ils sont liés aux applications Google, par exemple Google Docs ou Google Sheets, etc. Vous pouvez créer un script lié à un conteneur en sélectionnant des tools> Script editor de tools> Script editor dans Google App. Certaines fonctionnalités telles que les boîtes de dialogue, les invites, les menus et la barre latérale ne sont fournies que par les scripts liés aux conteneurs. En outre, un script lié à un conteneur est utilisé pour créer des modules complémentaires Google . Voir la documentation des scripts liés aux conteneurs.

Applications Web

Google App Script peut être utilisé en tant qu'application Web accessible par navigateur. Web App peut fournir une interface utilisateur sur le navigateur et utiliser des applications Google, par exemple des documents, des feuilles, etc. Les scripts et scripts autonomes liés à Google Apps peuvent être transformés en applications Web. Pour qu'un script fonctionne comme une application Web, le script doit répondre à deux exigences:

• inclure une fonction doGet() ou doPost() .
• La fonction renvoie un objet HTML service HtmlOutput ou un objet Content Service TextOutput.

Les fonctions Inshort, doGet() et doPost() fonctionnent respectivement comme les gestionnaires de requêtes et de requêtes HTTP.

Pour plus de détails sur les applications Web, consultez la documentation officielle.

Lancer / déboguer votre script

Essayez d'exécuter votre code à partir de la barre d'outils, comme indiqué ci-dessous:

Dans votre code, si vous avez plus d'une fonction, vous devez indiquer la fonction que vous souhaitez utiliser avant de l'exécuter. Par exemple :

Vous pouvez également appuyer sur ctrl + r depuis votre clavier pour exécuter le code. Il enregistrera d'abord le code, s'il n'est pas enregistré, puis l'exécutera. Mais pour que cela fonctionne, vous devez avoir sélectionné la fonction, comme indiqué dans l'image ci-dessus.

De plus, si votre script est appelé par des activités externes, vous pourrez toujours voir les journaux en cliquant sur view-> logs si vous enregistrez quelque chose après l'exécution du code.

Bonjour le monde

Nous allons dire bonjour comme un message.

function helloWorld() 
{
  Browser.msgBox("Hello World");
}

Pour exécuter le script, cliquez sur ▶ ou sélectionnez l’élément de menu Exécuter -> helloWorld

Un examen plus approfondi du script Google Apps

Google Apps Script est une plate-forme basée sur JavaScript, principalement utilisée pour automatiser et étendre Google Apps. Apps Script s'exécute exclusivement sur l'infrastructure de Google ne nécessitant aucun provisionnement ni configuration du serveur. Un IDE en ligne sert d'interface à l'ensemble de la plate-forme connectant tous les services disponibles à Apps Script. L'authentification de l'utilisateur est intégrée à la plate-forme via OAuth2 et ne nécessite aucun code ou configuration par l'auteur du script.

Apps Script s'exécute côté serveur, mais peut avoir des interfaces utilisateur créées avec HTML, CSS, JavaScript ou toute autre technologie prise en charge par le navigateur. Contrairement aux Nodejs, qui sont pilotés par des événements, les scripts d'application s'exécutent dans un modèle threadé. Tous les appels à un script génèrent une instance unique de ce script qui s'exécute indépendamment de toutes les autres instances. Lorsqu'une instance d'un script termine son exécution, elle est détruite.

Les fonctions du script Apps bloquent les fonctions de callback et de programmation asynchrone. Le verrouillage est utilisé pour empêcher l'exécution simultanée de sections de code critiques, telles que le fichier IO, par différentes instances.

En pratique, l'écriture d'applications est simple. Vous trouverez ci-dessous un script simple qui crée une nouvelle feuille de calcul à partir d'une feuille de calcul de modèle.

// Create a new spreadsheet from a template
function createSpreadsheet(){
   var templateFileId = '1Azcz9GwCeHjGl9TXf4aUh6g20Eqmgd1UMSdNVjzIZPk';
   var sheetName = 'Account Log for:' + new Date();
   SpreadsheetApp.openById(templateFileId).copy(sheetName);   
}