Projets de script

Un projet de script représente une collection de fichiers et de ressources dans Google Apps Script. Cette collection est parfois appelée 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 (une extension .html). Vous pouvez également inclure du code JavaScript et CSS dans les fichiers HTML.

L'éditeur de scripts n'a toujours qu'un seul projet ouvert à 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 New Project (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 dans 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, d'extraire et de déployer des projets Apps Script à partir d'un terminal.

Pour en savoir plus, consultez le guide 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, vous ne pouvez pas le récupérer.

1. Ouvrez votre projet lié au conteneur à l'aide de la méthode appropriée ci-dessus.
2. En haut à gauche, cliquez sur Vue d'ensemble .
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 Éditeur .
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 soit copier et coller le code de chaque fichier dans l'éditeur de texte de votre choix, soit utiliser clasp dans 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 d'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 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 le fuseau horaire dans votre fonction. Ainsi, 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 programmé en 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 aurez peut-être des difficultés à 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 à sélectionner 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 associé au module complémentaire ou à l'application Web auquel 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.