Projets Google Cloud

Chaque projet Apps Script utilise Google Cloud pour gérer les autorisations, les services avancés et d'autres détails. Pour configurer et gérer ces paramètres, chaque projet Apps Script est associé à un projet Google Cloud. Votre projet de script peut utiliser un projet par défaut créé automatiquement par Apps Script ou un projet standard que vous créez vous-même. En général, les projets par défaut conviennent aux scripts simples ou quotidiens. Toutefois, vous devez utiliser un projet standard pour toute application complexe, de qualité commerciale ou destinée à la publication.

Vous pouvez passer d'un projet par défaut à un projet standard à tout moment, mais vous ne pouvez pas revenir à un projet par défaut. Il est préférable de sélectionner le projet Google Cloud que votre script utilise au début du développement. Si vous changez d'abonnement plus tard, vous risquez de compliquer l'autorisation de vos utilisateurs.

Projets Google Cloud par défaut

Lorsque vous créez un projet Apps Script, celui-ci crée un projet Google Cloud par défaut qui s'exécute en arrière-plan.

  • Pour la plupart des scripts, vous n'aurez jamais besoin de voir ni d'ajuster ce projet par défaut. Apps Script gère les interactions nécessaires avec Google Cloud. Par exemple, si vous activez un service avancé dans l'éditeur Apps Script, ce dernier est activé dans le projet Google Cloud par défaut lorsque vous enregistrez le projet de script.
  • Pour certains scripts, vous devez interagir avec Google Cloud Console. Dans ce cas, votre script doit utiliser un projet Google Cloud standard. Par exemple, pour afficher les journaux Google Cloud dans Google Cloud Console, votre script doit utiliser un projet standard.

Afficher ou mettre à jour les projets Google Cloud par défaut

La plupart des utilisateurs ne peuvent pas localiser, afficher ni modifier directement les projets par défaut dans Google Cloud Console. Les administrateurs et les utilisateurs de domaine disposant de l'autorisation resourcemanager.projects.list sur le dossier Google Cloud parent peuvent afficher et configurer les projets par défaut.

  • Pour les clients Google Workspace, les projets par défaut appartiennent au dossier Organization root > system-gsuite > apps-script de la hiérarchie des ressources cloud. Ne supprimez pas ces dossiers. Dans ce cas, les scripts ne peuvent pas créer de projets par défaut et ne s'exécutent pas correctement.
  • Pour les clients autres que Google Workspace, les projets par défaut ne figurent pas dans la hiérarchie des ressources.

Supprimer les projets Google Cloud par défaut

Si vous êtes administrateur, vous pouvez supprimer les projets Google Cloud par défaut de la même manière que les projets Google Cloud standards. Consultez Supprimer les projets Google Cloud Apps Script.

Si vous n'êtes pas administrateur, vous ne pouvez pas supprimer les projets par défaut. Toutefois, Apps Script supprime les projets par défaut dans les cas suivants:

  • Si vous supprimez le projet de script ou que vous le remplacez par un projet standard, Apps Script supprime le projet par défaut associé au script, ainsi que les paramètres ou informations qu'il contient.
  • Si un script ne s'exécute pas pendant 180 jours ou plus, Apps Script supprime le projet par défaut associé. Si le script s'exécute après qu'Apps Script a supprimé son projet par défaut, il en crée un pour le script.

Projets Google Cloud standards

Les projets Google Cloud par défaut constituent la meilleure option pour la plupart des projets de script, sauf si vous devez les configurer manuellement. Dans ce cas, vous devez changer de projet de script pour utiliser un projet standard.

Les sections suivantes décrivent dans quels cas Apps Script requiert un projet standard, les propriétés de ces projets et les tâches courantes qu'ils effectuent. Vous ne pouvez effectuer les tâches ci-dessous qu'avec des projets standards.

Cas où Apps Script nécessite des projets Google Cloud standards

Vous devez utiliser un projet standard dans les situations suivantes:

Propriétés de projet Google Cloud standards

Les projets standards ont les propriétés suivantes:

  • Vous pouvez accéder à tous les paramètres Google Cloud du projet directement depuis la console Google Cloud. Cela vous permet d'activer des API, d'ajuster les identifiants d'autorisation et de configurer d'autres détails.
  • Lorsque vous supprimez un projet de script ou que vous le remplacez par un autre projet standard, le projet standard d'origine reste et peut être réutilisé.
  • Lorsque vous activez un service avancé dans un projet de script, vous devez activer manuellement l'API correspondante dans le projet standard.
  • Plusieurs projets de script et autres applications peuvent partager le même projet standard. Si vous avez l'intention de publier un projet de script dans Google Workspace Marketplace en tant que module complémentaire, il doit disposer de son propre projet standard. Les applications publiées ne peuvent pas partager des projets Google Cloud avec d'autres applications.
  • Si vous souhaitez exécuter des fonctions d'un projet de script à partir d'une autre application à l'aide de la méthode scripts.run de l'API Apps Script, le projet de script et l'application appelante doivent partager le même projet standard.
  • Lorsque Apps Script demande à un utilisateur d'autoriser un script utilisant un projet standard, le nom de projet Google Cloud est utilisé pour identifier le script (et non le nom du projet). C'est pourquoi vous devez définir un nom de projet Google Cloud approprié.

Accéder à un projet Google Cloud standard

Pour accéder au projet standard associé à votre projet de script, procédez comme suit:

Nouvel éditeur

  1. Ouvrez le projet Apps Script.
  2. Sur la gauche, cliquez sur Paramètres du projet .
  3. Sous Projet Google Cloud Platform (GCP), cliquez sur le numéro du projet.

Ancien éditeur

  1. Ouvrez le script dans l'éditeur Apps Script.
  2. Sélectionnez Ressources > Cloud Platform project (Projet Cloud Platform).
  3. Dans la boîte de dialogue qui s'ouvre, cliquez sur le lien supérieur faisant référence au nom du projet GCP.

Vous pouvez également trouver un projet standard directement sur la page Gérer les ressources de Google Cloud Console.

Activer une API dans un projet Google Cloud standard

Une application Apps Script a souvent besoin d'accéder à une autre API Google. Pour ce faire, vous devez activer l'API dans le projet Google Cloud correspondant. Pour activer une API:

  1. Ouvrez le projet Google Cloud.
  2. Cliquez sur Menu > API et services.
  3. Cliquez sur Activer les API et les services.
  4. Dans le champ de recherche, saisissez l'API que vous souhaitez activer, puis appuyez sur Entrée.
  5. Cliquez sur l'API dans les résultats de recherche, puis sur Activer afin d'activer l'API pour ce projet Google Cloud.

Vous serez peut-être invité à accepter les conditions d'utilisation des API Google ou de Google Cloud. Lisez attentivement les conditions d'utilisation avant de les accepter.

En fonction de l'application, vous devrez peut-être également configurer l'API en la sélectionnant dans le tableau de bord API et services.

Déterminer l'ID d'un projet Google Cloud standard

Tous les projets Google Cloud ont un nom, un ID et un numéro. Parfois, vous devez disposer de ces identifiants pour configurer les services ou effectuer d'autres tâches.

Pour déterminer l'ID et le numéro de votre projet standard, procédez comme suit:

  1. Ouvrez le projet Google Cloud.
  2. En haut à droite, cliquez sur Plus > Paramètres du projet.
  3. Affichez le nom du projet, l'ID du projet et le numéro du projet dans le panneau Paramètres qui s'affiche. Le numéro de projet n'est composé que de chiffres, tandis que l'ID du projet est alphanumérique. Vous pouvez modifier le nom du projet, qui s'affiche lorsque les utilisateurs demandent une autorisation.

Afficher les journaux des erreurs et les journaux Google Cloud dans Google Cloud Console

Si vous utilisez Cloud Logging ou les rapports d'erreurs pour votre projet de script, vous pouvez afficher ces journaux et ces rapports dans la console Google Cloud en procédant comme suit:

  1. Ouvrez le projet Google Cloud.
  2. Cliquez sur Menu .
  3. Faites défiler la page jusqu'à la section Operations (Opérations), puis cliquez sur Logging > Logs explorer (Explorateur de journaux).
  4. Pour afficher les rapports d'erreurs, faites défiler la page jusqu'à la section Opérations et cliquez sur Error Reporting. Si vous êtes invité à configurer la création de rapports d'erreurs, cela signifie que votre projet de script n'a pas encore enregistré d'exceptions.

Lorsque vous utilisez des services nécessitant OAuth, Google invite les utilisateurs à autoriser ces services. Les paramètres de l'écran de consentement OAuth vous permettent de définir certaines informations que Google présente aux utilisateurs, comme le nom de l'application et l'URL des conditions d'utilisation.

Les projets Google Cloud par défaut créent automatiquement un écran de consentement à partir des détails du projet Apps Script. Vous ne pouvez pas ajuster ces paramètres. Les projets Google Cloud standards vous permettent de personnaliser ces informations. Pour configurer l'écran de consentement de votre script, procédez comme suit:

  1. Ouvrez le projet Google Cloud.
  2. Cliquez sur Menu > API et services > Identifiants.
  3. Cliquez sur Configurer l'écran d'autorisation.
  4. Remplissez chaque section du workflow de l'écran de consentement.
  5. Pour enregistrer vos modifications à chaque étape du workflow, cliquez sur Enregistrer et continuer.

Créer des identifiants OAuth

Apps Script configure généralement OAuth pour les services utilisés par votre script. Pour certaines applications, vous devez créer des identifiants OAuth supplémentaires (ID client et codes secrets du client). Vous ne pouvez le faire qu'avec des projets standards.

Pour créer un ID client et un code secret pour votre projet de script, procédez comme suit:

  1. Ouvrez le projet Google Cloud.
  2. Cliquez sur Menu > API et services > Identifiants.
  3. Cliquez sur Créer des identifiants > ID client OAuth.
  4. Sous Type d'application, sélectionnez votre type d'application et remplissez le formulaire qui s'affiche si nécessaire. Lorsque vous avez terminé, cliquez sur Créer.
  5. Dans la boîte de dialogue, cliquez sur Télécharger JSON. Vous pouvez l'utiliser pour configurer OAuth.

Ajouter des propriétaires à un projet Google Cloud standard

Vous pouvez ajouter des propriétaires ou d'autres rôles à un projet standard. Si vous collaborez sur un projet, vous vous assurez qu'un membre de votre équipe aura toujours accès aux paramètres Google Cloud du projet de script.

Pour ajouter des propriétaires ou d'autres rôles à un projet standard, procédez comme suit : Vous devez être autorisé à modifier le projet pour effectuer l'une de ces modifications:

  1. Déterminez qui sont vos collaborateurs. Nous vous recommandons de créer ou d'utiliser un groupe Google existant. Vous pouvez également spécifier des domaines dans la liste des collaborateurs pour inclure tous les utilisateurs de ce domaine.
  2. Ouvrez le projet Google Cloud du script.
  3. Cliquez sur Menu > IAM & admin > IAM.
  4. En haut de la page, cliquez sur Ajouter.
  5. Suivez les instructions à l'écran pour ajouter un ou plusieurs nouveaux membres et leurs rôles au projet Google Cloud. Vous pouvez ajouter des adresses e-mail, des groupes Google ou des domaines en tant que nouveaux membres.
  6. Cliquez sur Enregistrer.

Regrouper plusieurs scripts avec un seul projet Google Cloud

Plusieurs projets Apps Script peuvent être associés au même projet Google Cloud standard. Pour ce faire, créez un projet standard, puis changez de projet de script pour l'utiliser. Vous ne pouvez pas effectuer cette opération avec les projets par défaut.

Basculer vers un autre projet Google Cloud standard

Vous pouvez changer de projet de script pour qu'il utilise un autre projet Google Cloud standard. Vous devez passer à un projet standard si votre script nécessite une configuration manuelle du projet Google Cloud. Pour savoir dans quels cas vous devez utiliser un projet standard, consultez la section Projets Google Cloud standards.

Pour basculer un projet Google Cloud existant vers un autre projet Google Cloud, procédez comme suit:

Nouvel éditeur

  1. Si vous n'avez pas de projet Google Cloud approprié, créez-en un en suivant les instructions de la section Créer un projet. Définissez un nom de projet facile à retenir afin de pouvoir le localiser sur la page Google Cloud Gérer les ressources. Apps Script utilise ce nom pour demander l'autorisation du script.
  2. Si vous souhaitez utiliser un projet existant, ouvrez la page Gérer les ressources de Google Cloud Console et localisez le projet à utiliser. Vous devez disposer des autorisations resourcemanager.projects.update pour le projet. Vous ne pouvez pas utiliser un projet créé automatiquement par Apps Script.
  3. Déterminez le numéro de votre projet Google Cloud.
  4. Ouvrez le script dont vous souhaitez remplacer le projet Google Cloud.
  5. Sur la gauche, cliquez sur Paramètres du projet .
  6. Sous Projet Google Cloud Platform (GCP), cliquez sur Modifier le projet.
  7. Saisissez le nouveau numéro de projet, puis cliquez sur Définir le projet.

Ancien éditeur

  1. Si vous n'avez pas de projet GCP approprié, créez-en un en suivant les instructions de la section Créer un projet. Sinon, ouvrez la page Gérer les ressources de Google Cloud Console et localisez le projet GCP à utiliser. Vous devez être autorisé à modifier le projet GCP et pouvoir afficher ses paramètres dans la console Google Cloud. Le nouveau projet ne peut pas être créé automatiquement par Apps Script.
  2. Définissez un nom de projet GCP facile à retenir pour pouvoir le retrouver plus facilement sur la page Gérer les ressourcesGoogle Cloud Console. Ce nom est également utilisé pour identifier le script lorsque Apps Script demande aux utilisateurs de l'autoriser.
  3. Déterminez le numéro de votre projet GCP.
  4. Dans l'éditeur Apps Script, ouvrez le script dont vous souhaitez remplacer le projet GCP.
  5. Cliquez sur Ressources > Cloud Platform project (Projet Cloud Platform).
  6. Dans la section Changer de projet, collez le numéro de projet que vous avez copié dans le champ de texte, puis cliquez sur Définir un projet.
  7. Un écran d'avertissement explique les effets de la modification du projet Cloud Platform. Lisez attentivement la notification, puis cliquez sur Confirmer.

Projets Google Cloud et Drive partagés

Les Drive partagés (anciennement Drive d'équipe) sont des espaces partagés dans lesquels des groupes d'utilisateurs Drive peuvent collaborer sur des projets Apps Script et des documents Drive. Les Drive partagés sont utiles pour développer des scripts, des modules complémentaires et des applications Web avec une équipe, mais ils imposent des restrictions sur ce que vous pouvez faire avec d'anciens projets Google Cloud par défaut.

La liste de restrictions suivante décrit la manière dont les projets Google Cloud interagissent avec les Drive partagés:

  • Si votre projet de script utilise un projet standard, il n'existe aucune restriction supplémentaire lorsque celui-ci se trouve dans un Drive partagé.
  • Si votre projet de script utilise un projet par défaut créé le 8 avril 2019 ou après cette date, aucune restriction supplémentaire ne s'applique lorsque le projet de script se trouve dans un Drive partagé.
  • Si votre projet de script utilise un projet par défaut créé avant le 8 avril 2019, les restrictions suivantes s'appliquent lorsque le projet de script se trouve sur un Drive partagé :
    1. Vous ne pouvez pas accéder au projet par défaut à l'aide de l'interface utilisateur d'Apps Script ou de Google Cloud Console. Cette restriction vous empêche d'effectuer des actions nécessitant un accès direct au projet.
    2. Vous ne pouvez pas activer les services avancés. Pour activer les services avancés, basculez vers un projet standard.
    3. Lorsque vous déplacez un projet Apps Script existant vers un Drive partagé, Google restreint l'accès au projet Google Cloud par défaut. Vous pouvez toujours accéder au projet par défaut si vous aviez accès avant le déplacement. Par exemple, si vous avez créé un script dans votre dossier Mon Drive, puis que vous l'avez déplacé dans un Drive partagé, vous pouvez toujours accéder au projet Google Cloud du script. Vos collaborateurs du Drive partagé n'y auront peut-être pas accès.
    4. Un script conserve le nom du projet Google Cloud dont il disposait avant de le déplacer vers un Drive partagé. Même si vous modifiez le nom du projet sur le Drive partagé, les utilisateurs qui autorisent le script voient toujours l'ancien nom dans les boîtes de dialogue d'autorisation.

Pour éviter les restrictions ci-dessus pour les anciens scripts, passez à un projet standard.

Obtenir la liste des projets Google Cloud Apps Script

Si vous disposez de l'autorisation resourcemanager.projects.list pour le dossier du projet Apps Script de votre organisation, vous pouvez afficher tous les projets Google Cloud Apps Script standards et par défaut du dossier.

  1. Ouvrez la page Google Cloud Console Gérer les ressources.
  2. À côté du dossier Apps Script, copiez l'ID.
  3. Cliquez sur Filter > Parent ID (Filtrer), puis collez l'ID du dossier Apps Script.

Supprimer les projets Google Cloud Apps Script

Pour supprimer un projet Google Cloud Apps Script, suivez la procédure décrite dans Obtenir la liste des projets Google Cloud Apps Script, sélectionnez le projet que vous souhaitez supprimer et cliquez sur Supprimer.

Pour supprimer un projet Apps Script à l'aide de gcloud, utilisez les commandes suivantes.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Pour en savoir plus sur la suppression de projets Google Cloud, consultez la page Arrêter (supprimer) des projets.