Projets Google Cloud

Chaque projet Google 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 qu'Apps Script crée automatiquement ou un projet standard que vous créez vous-même. En général, les projets par défaut conviennent aux scripts quotidiens, mais vous devez utiliser un projet standard pour toute application complexe, de qualité commerciale ou que vous avez l'intention de publier.

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 Cloud utilisé par votre script dès le début du développement. Si vous changez de compte plus tard, cela peut entraîner des complications, comme obliger vos utilisateurs à se réauthentifier.

Projets Cloud par défaut

Lorsque vous créez un projet Apps Script, un projet Cloud par défaut est créé en arrière-plan.

  • Pour la plupart des scripts, vous n'avez 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, Apps Script active le service avancé dans le projet Cloud par défaut lorsque vous enregistrez le projet de script.
  • Pour certains scripts, vous devez interagir avec la console Google Cloud. Dans ce cas, votre script doit utiliser un projet Cloud standard. Par exemple, pour afficher les journaux Google Cloud dans la console Google Cloud, votre script doit utiliser un projet standard.

Par défaut, les projets Cloud disposent d'une stratégie Identity and Access Management (IAM) avec une entrée, un compte de service Google qui fait office de propriétaire du projet par défaut. Le compte de service Google est appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Afficher ou modifier les projets Cloud par défaut

La plupart des utilisateurs ne peuvent pas localiser, afficher ni modifier directement les projets par défaut dans la console Google Cloud. Si vous êtes administrateur, consultez Afficher les projets Google Cloud par défaut.

Si vous avez créé votre projet de script avant le 8 avril 2019, vous pouvez utiliser un projet par défaut auquel vous pouvez accéder dans la console Google Cloud. Pour accéder au projet par défaut, accédez aux paramètres du projet de script et cliquez sur le numéro du projet.

Supprimer les projets Cloud par défaut

Si vous êtes administrateur, vous pouvez supprimer les projets Cloud par défaut comme vous le feriez pour les projets Cloud standards. Consultez Afficher ou modifier les projets Cloud par défaut.

Les utilisateurs non administrateurs ne peuvent pas supprimer manuellement les projets par défaut. Toutefois, si vous supprimez le projet de script ou passez à un projet standard, Apps Script supprime le projet par défaut associé au script, ainsi que ses paramètres et informations.

Projets Cloud standards

Les projets Cloud par défaut sont la meilleure option pour la plupart des projets de script, sauf si vous devez configurer manuellement le projet. Dans ce cas, vous devez passer à un projet standard pour votre projet de script.

Les sections suivantes décrivent les cas dans lesquels Apps Script nécessite un projet standard, ses propriétés et les tâches courantes. N'effectuez ces tâches qu'avec des projets standards.

Quand Apps Script nécessite des projets Cloud standards

Vous devez utiliser un projet standard dans les cas suivants :

Propriétés standards des projets Cloud

Les projets standards présentent les propriétés suivantes :

  • Accédez à 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 modifiez pour utiliser un autre projet standard, le projet standard d'origine est conservé 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 d'autres applications peuvent partager le même projet standard. Si vous prévoyez de publier un projet de script sur la Marketplace en tant que module complémentaire, il doit avoir son propre projet standard. Les applications publiées ne peuvent pas partager de projets Cloud avec d'autres applications.
  • Si vous souhaitez exécuter des fonctions dans 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 qui utilise un projet standard, le nom du projet Cloud est utilisé pour identifier le script (et non le nom du projet de script). Pour cette raison, veillez à définir un nom de projet Cloud approprié.

Accéder à un projet Cloud standard

Pour accéder au projet standard associé à votre projet de script :

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

Recherchez un projet standard directement sur la page Gérer les ressources de la console Google Cloud.

Activer une API dans un projet Cloud standard

Pour autoriser une application Apps Script à accéder à une autre API Google, activez l'API dans le projet Cloud correspondant :

  1. Ouvrez le projet 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.

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.

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

Déterminer l'ID et le numéro d'un projet Cloud standard

Tous les projets Cloud possèdent un nom, un ID et un numéro. Vous aurez peut-être besoin de ces identifiants pour configurer des services ou effectuer d'autres tâches.

Pour déterminer l'ID et le numéro de votre projet standard :

  1. Ouvrez le projet 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 est composé de chiffres, tandis que l'ID de projet est alphanumérique. Modifiez le nom du projet, qui s'affiche pour les utilisateurs lors des invites d'autorisation.

Afficher les journaux et les rapports d'erreur Google Cloud dans la console Google Cloud

Si vous utilisez la journalisation Google Cloud ou le signalement des erreurs pour votre projet de script, vous pouvez afficher ces journaux et rapports dans la console Google Cloud en procédant comme suit :

  1. Ouvrez le projet Cloud.
  2. Cliquez sur Menu .
  3. Dans la section Opérations, cliquez sur Journalisation > Explorateur de journaux.
  4. Pour afficher les rapports d'erreur, dans la section Opérations, cliquez sur Rapports d'erreur. Si vous êtes invité à configurer le signalement des erreurs, cela signifie que votre projet de script n'a encore enregistré aucune exception.

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

Les projets 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 Cloud standards vous permettent de personnaliser ces informations. Pour configurer l'écran de consentement de votre script :

  1. Ouvrez le projet 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 d'autorisation.
  5. Pour enregistrer vos modifications à chaque étape, 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, créez des identifiants OAuth supplémentaires (ID client et secrets client). Ne le faites que pour les projets standards.

Pour créer un ID client et un code secret client pour votre projet de script :

  1. Ouvrez le projet 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. Lorsque vous avez terminé, cliquez sur Créer.
  5. Dans la boîte de dialogue, cliquez sur Télécharger JSON. Utilisez ce fichier pour configurer OAuth.

Ajouter des propriétaires supplémentaires à un projet Cloud standard

Ajoutez d'autres propriétaires ou rôles à un projet standard pour vous assurer qu'un membre de votre équipe a 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 (vous devez disposer des autorisations de modification) :

  1. Déterminez vos collaborateurs. Nous vous recommandons d'utiliser un groupe Google. Spécifiez les domaines pour inclure tous les utilisateurs de ces domaines.
  2. Ouvrez le projet Cloud du script.
  3. Cliquez sur Menu  > IAM et administration > IAM.
  4. En haut de la page, cliquez sur Ajouter.
  5. Suivez les instructions à l'écran pour ajouter des membres et leurs rôles. Ajoutez des adresses e-mail individuelles, des groupes Google ou des domaines.
  6. Cliquez sur Enregistrer.

Regrouper plusieurs scripts avec un seul projet Cloud

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

Si vous souhaitez publier votre projet de script sur la Marketplace en tant que module complémentaire, il doit disposer de son propre projet standard. Les applications publiées ne peuvent pas partager de projets Cloud.

Utiliser un autre projet Cloud standard

Basculez un projet de script pour qu'il utilise un autre projet Cloud standard. Si votre script nécessite une configuration manuelle du projet Cloud, passez d'un projet par défaut à un projet standard. Pour en savoir plus, consultez Projets Cloud standards.

Conséquences du passage à un autre projet Cloud standard

Si vous passez d'un projet par défaut à un autre projet standard pour votre script, les effets suivants se produisent :

  • Si vous avez activé des services avancés pour votre script, vous devez activer les API correspondantes dans le nouveau projet Cloud. Vous perdez toutes les données associées aux services avancés de l'ancien projet Cloud. Pour savoir comment activer les API dans votre projet Cloud, consultez Activer les API Google Workspace.
  • Si votre script utilise le service Google Drive intégré, vous devez activer l'API Drive dans les projets Cloud standards.

    Dans votre projet Cloud standard, activez l'API Drive :

    Activer l'API Drive

  • Tous les utilisateurs qui ont déjà autorisé le script doivent le réautoriser. Dans la plupart des cas, tous les utilisateurs qui ont déjà autorisé les applications associées au nouveau projet doivent également les autoriser à nouveau.
  • Si votre script est associé à une fiche d'application sur Google Workspace Marketplace, votre fiche d'application, vos utilisateurs et vos avis ne sont pas transférés vers le nouveau projet. Vous devez créer une fiche d'application dans le nouveau projet et vos utilisateurs doivent réinstaller votre application. Pour savoir comment créer une fiche d'application, consultez Publier une application.
  • Vous ne pouvez pas repasser à un projet par défaut. Apps Script supprime les projets par défaut une fois que vous avez configuré le script pour qu'il utilise un projet standard.

Passer à un autre projet Cloud standard

Pour transférer le projet Cloud existant d'un script vers un autre projet Cloud, procédez comme suit :

  1. Si vous n'avez pas de projet Cloud adapté, créez-en un en suivant les instructions de la section Créer un projet. Définissez un nom de projet facile à retenir pour le retrouver sur la page Gérer les ressources de la console Google Cloud. Apps Script utilise ce nom lorsqu'il demande aux utilisateurs d'autoriser le script.
  2. Si vous souhaitez utiliser un projet existant, ouvrez la page Gérer les ressources de la console Google Cloud et recherchez un projet existant à utiliser. Vous devez disposer des rôles "Navigateur de projet" et "Éditeur de configuration OAuth", ou de rôles avec des autorisations équivalentes, pour le projet. Vous ne pouvez pas utiliser un projet créé automatiquement par Apps Script.
  3. Déterminez le numéro de projet de votre projet Cloud.
  4. Ouvrez le script dont vous souhaitez remplacer le projet Cloud.
  5. À gauche, cliquez sur Paramètres du projet .
  6. Sous Projet Google Cloud, cliquez sur Changer de projet.
  7. Saisissez le nouveau numéro de projet, puis cliquez sur Définir le projet.

Projets cloud et Drive partagés

Les lecteurs partagés ne sont disponibles que pour les clients Google Workspace Business et Google Workspace Enterprise.

Les Drive partagés (anciennement appelés "Drive d'équipe") offrent des espaces partagés où des groupes d'utilisateurs Drive peuvent collaborer sur des projets Apps Script et des documents Drive. Les lecteurs partagés sont utiles lorsque vous développez des scripts, des modules complémentaires et des applications Web avec une équipe, mais ils imposent certaines restrictions sur ce que vous pouvez faire avec les anciens projets Cloud par défaut.

La liste suivante décrit comment les projets Cloud interagissent avec les lecteurs partagés :

  • Si votre projet de script utilise un projet standard, aucune restriction supplémentaire ne s'applique lorsque le projet de script réside dans un Drive partagé.
  • Si votre projet de script utilise un projet par défaut créé le 8 avril 2019 ou après, il n'y a pas de restrictions supplémentaires lorsque le projet de script réside 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 tant que le projet de script réside sur un drive partagé :
    1. Vous ne pouvez pas accéder au projet par défaut à l'aide de l'interface utilisateur Apps Script ni de la console Google Cloud. 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, passez à un projet standard.
    3. Lorsque vous déplacez un projet Apps Script existant vers un Drive partagé, Google limite l'accès au projet Cloud par défaut. Vous pouvez toujours accéder au projet par défaut si vous y aviez accès avant le transfert. Par exemple, si vous avez créé un script dans votre dossier "Mon Drive" et que vous l'avez ensuite déplacé dans un Drive partagé, vous pouvez toujours accéder au projet Cloud du script. Il est possible que vos collaborateurs dans le Drive partagé ne puissent pas le faire.
    4. Un script conserve le nom du projet Cloud qu'il avait avant d'être déplacé 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 ces restrictions pour les anciens scripts, passez à un projet standard.

Obtenir la liste des projets Cloud Apps Script

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

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

Supprimer des projets Apps Script Cloud

Vous devez être administrateur pour supprimer les projets par défaut.

Pour supprimer un projet Apps Script de la console Google Cloud :

  1. Ouvrez le projet Cloud.
  2. En haut à droite, cliquez sur Plus  > Paramètres du projet.
  3. Cliquez sur Arrêter / Supprimer.
  4. Suivez les instructions à l'écran pour arrêter le projet.

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 Cloud, consultez Arrêter (supprimer) des projets.