Projets de script

Un projet de script représente un ensemble de fichiers et de ressources dans Google Apps Script, parfois simplement appelé "script". Un projet de script contient un ou plusieurs fichiers de script, qui peuvent être des fichiers de code (avec une extension .gs) ou des fichiers HTML (avec l'extension .html). Vous pouvez également inclure du code JavaScript et CSS dans des fichiers HTML.

L'éditeur de script n'affiche qu'un seul projet à la fois. Vous pouvez ouvrir plusieurs projets dans plusieurs fenêtres ou onglets de navigateur.

Créer et supprimer des projets

Cette section explique comment créer et supprimer des projets Apps Script autonomes ou liés à un conteneur.

Créer un projet autonome

Pour créer un projet autonome à partir d'Apps Script:

  1. Accédez à script.google.com.
  2. Cliquez sur  Nouveau projet.
  3. Dans l'éditeur de script, cliquez sur Projet sans titre.
  4. Attribuez un nom à votre projet, puis cliquez sur Renommer.

Créer un projet autonome depuis Google Drive

  1. Ouvrez Google Drive.
  2. Cliquez sur Nouveau > Plus > Google Apps Script.

Créer un projet lié à un conteneur à partir de Google Docs, Sheets ou Slides

  1. Ouvrez un document Docs, une feuille de calcul Sheets ou une présentation Slides.
  2. Cliquez sur Extensions > Google Apps Script.
  3. Dans l'éditeur de script, cliquez sur Projet sans titre.
  4. Attribuez un nom à votre projet, puis cliquez sur Renommer.

Créer un projet lié à un conteneur à partir de Google Forms

  1. Ouvrez un formulaire dans Google Forms.
  2. Cliquez sur Plus  > Éditeur de script.
  3. Dans l'éditeur de script, cliquez sur Projet sans titre.
  4. Attribuez un nom à votre projet, puis cliquez sur Renommer.

Créer un projet autonome à l'aide de l'outil de ligne de commande clasp

clasp est un outil de ligne de commande qui vous permet de créer, de récupérer/d'envoyer et de déployer des projets Apps Script à partir d'un terminal.

Pour en savoir plus, consultez le guide de l'interface de ligne de commande avec clasp.

Supprimer un projet lié à un conteneur

  1. Ouvrez votre projet lié à un conteneur à l'aide de la méthode appropriée ci-dessus.
  2. En haut à gauche, cliquez sur Aperçu .
  3. En haut à droite, cliquez sur Supprimer  > Supprimer définitivement.

Supprimer un projet autonome

  1. Accédez à script.google.com.
  2. À droite du projet que vous souhaitez supprimer, cliquez sur Plus > Supprimer > Supprimer.

Gérer les fichiers d'un projet

Créer un fichier

  1. Ouvrez votre projet Apps Script.
  2. Sur la gauche, cliquez sur Éditeur > Ajouter .
  3. Sélectionnez le type de fichier à créer et donnez-lui un nom.

Supprimer un fichier

  1. Ouvrez votre projet Apps Script.
  2. À gauche, cliquez sur Montage .
  3. À côté du fichier que vous souhaitez supprimer, cliquez sur Plus > Supprimer.

Exporter des fichiers à partir d'un projet Apps Script

Pour extraire des fichiers de code d'Apps Script, vous pouvez copier et coller le code de chaque fichier dans votre éditeur de texte préféré ou utiliser clasp sur la ligne de commande. Pour utiliser clasp, consultez Télécharger un projet de script.

Définir le fuseau horaire d'un projet

Vous pouvez définir le fuseau horaire d'un projet Apps Script. Les fonctions exécutées par le script utilisent ce fuseau horaire.

  1. Ouvrez votre projet Apps Script.
  2. Sur la gauche, cliquez sur Paramètres du projet Icône des paramètres du projet.
  3. Dans la section Fuseau horaire, sélectionnez le fuseau horaire que vous souhaitez utiliser.

Si vous souhaitez qu'une fonction spécifique utilise un fuseau horaire différent de celui du projet de script, saisissez explicitement ce fuseau dans votre fonction. Par exemple, dans l'exemple ci-dessous, chaque fonction crée un événement dans Google Agenda. La première fonction utilise par défaut le fuseau horaire du projet. La deuxième fonction spécifie le fuseau horaire du Pacifique. L'événement est donc planifié dans ce fuseau horaire, quel que soit le fuseau horaire du projet.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

Résoudre les problèmes liés à plusieurs comptes Google

Si vous êtes connecté à plusieurs comptes Google en même temps, vous pouvez rencontrer des difficultés pour accéder à vos modules complémentaires et à vos applications Web. Les connexions multiples ou la connexion simultanée à plusieurs comptes Google ne sont pas compatibles avec Apps Script, les modules complémentaires ni les applications Web.

  • Si vous ouvrez l'éditeur Apps Script alors que vous êtes connecté à plusieurs comptes, Google vous invite à choisir le compte que vous souhaitez utiliser.

  • Si vous ouvrez une application Web ou un module complémentaire et que vous rencontrez des problèmes de connexions multiples, essayez l'une des solutions suivantes:

    • Déconnectez-vous de tous vos comptes Google et connectez-vous uniquement à celui qui est associé au module complémentaire ou à l'application Web que vous souhaitez utiliser.
    • Ouvrez une fenêtre de navigation privée dans Google Chrome ou une fenêtre de navigation privée équivalente, puis connectez-vous au compte Google associé au module complémentaire ou à l'application Web que vous souhaitez utiliser.