Projets de script

Un projet de script représente un ensemble de fichiers et de ressources dans Google Apps Script, parfois appelé simplement "un 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 JavaScript et CSS dans les fichiers HTML.

L'éditeur de script n'a toujours ouvert 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 scripts.
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 transférer 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 à l'aide de clasp.

Supprimer un projet lié à un conteneur

Avertissement :Une fois que vous avez supprimé un projet Apps Script lié à un conteneur, il ne peut pas être récupéré.

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.

Seul le propriétaire du conteneur peut voir les options du menu de suppression.

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

Create a file (Créer un fichier)

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

Supprimer un fichier

Les fichiers supprimés ne peuvent pas être récupérés.

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 depuis un projet Apps Script

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

Définir le fuseau horaire d'un projet

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

1. Ouvrez votre projet Apps Script.
2. Sur la gauche, cliquez sur Project Settings (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. Dans l'exemple ci-dessous, chaque fonction crée un événement dans Google Agenda. Par défaut, la première fonction est définie sur le fuseau horaire du projet. La deuxième fonction spécifie le fuseau horaire du Pacifique. L'événement est donc planifié selon l'heure du Pacifique, 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. La connexion multicompte ou la connexion à plusieurs comptes Google à la fois 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 avec lequel vous souhaitez continuer.

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

  • Déconnectez-vous de tous vos comptes Google, puis connectez-vous uniquement à celui qui contient le module complémentaire ou l'application Web auxquels vous souhaitez accéder.
  • 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 contenant le module complémentaire ou l'application Web auquel vous souhaitez accéder.