Tous les projets Apps Script utilisent Google Cloud pour gérer les autorisations, 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 projet default utilisé par Apps Script crée automatiquement projet standard que vous créez vous-même. En général, les projets par défaut sont adaptés au quotidien des scripts, mais vous devez utiliser un projet standard pour toute application est 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 pour sélectionner le projet Cloud que votre script utilise au début du développement. Passer à un autre système plus tard peut entraîner des complications, par exemple en obligeant vos utilisateurs à réautoriser l'application.
Projets Cloud par défaut
Lorsque vous créez un projet Apps Script, Apps Script crée un script par défaut Google Cloud qui s'exécute en arrière-plan.
- Pour la plupart des scripts, vous n'aurez jamais besoin de consulter ni d'ajuster ce projet par défaut. Applications Le 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 ces votre script doit utiliser un projet Cloud standard. Pour 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'un
(IAM) avec une entrée, un compte de service Google propriétaire
le projet par défaut. Le compte de service Google
appsdev-apps-dev-script-auth@system.gserviceaccount.com
Afficher ou mettre à jour les projets Cloud par défaut
La plupart des utilisateurs ne peuvent pas localiser, afficher ou modifier directement les projets par défaut dans le 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 par défaut auquel vous pouvez accéder dans la console Google Cloud. Pour accéder au par défaut, accédez aux paramètres du projet de script et cliquez sur le nom du projet numéro.
Supprimer les projets Cloud par défaut
Si vous êtes administrateur, vous pouvez supprimer les projets Cloud par défaut comme vous le feriez les projets Cloud standards. Consultez Supprimer des projets 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 si vous le changez pour utiliser un projet standard, Le script supprime le projet par défaut qui lui est associé, ainsi que les paramètres ou informations qu'il contient.
- Si un script n'est pas exécuté pendant 180 jours ou plus, Apps Script supprime le projet par défaut associé. Si le script s'exécute après Apps Script supprime son projet par défaut, Apps Script en crée un pour le script.
Projets Cloud standards
Les projets Cloud par défaut constituent la meilleure option pour la plupart sauf si vous devez configurer manuellement le projet. Dans ce cas, vous devez passer à un projet standard.
Les sections suivantes décrivent quand Apps Script requiert un projet standard, les propriétés de ces projets et les tâches courantes qui y sont réalisées. Vous pouvez uniquement effectuer les tâches ci-dessous avec des projets standards :
Lorsque Apps Script nécessite des projets Cloud standards
Vous devez utiliser un projet standard dans les situations suivantes:
- Pour publier votre projet de script en tant que module complémentaire dans Google Workspace Marketplace.
- Pour vérifier le client OAuth de votre projet de script.
- Lorsque l'une de vos applications doit exécuter des fonctions
à l'aide de la commande
Méthode
scripts.run
de l'API Apps Script - Pour afficher les événements journaux Google Cloud dans le Console Google Cloud La console Google Cloud offre davantage d'outils d'afficher les journaux, et peut s'avérer plus utile que la vue simplifiée fournie par le tableau de bord Apps Script.
- Pour afficher les rapports d'erreurs de votre projet de script à l'aide de Error Reporting.
- Pour créer une boîte de dialogue d'ouverture de fichier :
- Lorsque vous avez besoin d’un contrôle manuel sur les paramètres de Google Cloud.
Propriétés de projet Cloud standards
Les projets standards ont les propriétés suivantes:
- Vous pouvez accéder directement à tous les paramètres Google Cloud du projet depuis la console Google Cloud. Cela vous permet d'activer des API, d'ajuster les autorisations les identifiants et configurer les autres détails.
- Lorsque vous supprimez un projet de script ou que vous passez à 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 projet standard.
- Plusieurs projets de script et d'autres applications peuvent partager le même projet standard. Si vous avez l'intention de publier un projet de script vers Google Workspace Marketplace en tant que module complémentaire, elle doit avoir son propre projet standard. Impossible de partager des applications publiées des projets Google Cloud avec d'autres applications.
- Si vous souhaitez exécuter des fonctions dans un projet de script à partir d'une autre application en utilisant
la méthode
scripts.run
de l'API Apps Script ; le projet de script et l'application appelante doivent partager le même standard projet. - 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 du script). Par conséquent, veillez à définir un nom du projet Google Cloud.
Accéder à un projet Cloud standard
Pour accéder au projet standard associé à votre script , procédez comme suit:
- Ouvrez le projet Apps Script.
- Sur la gauche, cliquez sur Paramètres du projet .
- Sous Projet Google Cloud Platform (GCP), cliquez sur le numéro du projet.
Vous trouverez également un projet standard directement sur la page Gérer les ressources de la console Google Cloud.
Activer une API dans un projet 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 Cloud correspondant. Activez une API en procédant comme suit:
- Ouvrez le projet Cloud.
- Cliquez sur Menu > API et Services. .
- Cliquez sur Activer les API et les services.
- Dans le champ de recherche, saisissez l'API que vous souhaitez activer, puis appuyez sur Entrée.
- Cliquez sur l'API dans les résultats de recherche, puis sur Activer pour l'activer. l'API pour ce projet Cloud.
Vous serez peut-être invité à accepter les conditions d'utilisation de API Google ou Google Cloud : Lire les conditions avant de les accepter.
En fonction de l'application, vous devrez peut-être également configurer l'API sélectionnez-le dans la section API et Google Cloud.
Déterminez l'ID et numéro d'un projet Cloud standard
Tous les projets Cloud possèdent un nom, un ID et un numéro de projet. De temps en temps, vous devez avoir 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, procédez comme suit:
- Ouvrez le projet Cloud.
- En haut à droite, cliquez sur Plus > Paramètres du projet. .
- Afficher le nom du projet, l'ID du projet et le numéro du projet dans le panneau Settings (Paramètres) qui s'affiche. Le numéro de projet se compose uniquement des chiffres, tandis que l'ID de projet est alphanumérique. Vous pouvez modifier le Nom du projet, qui s'affiche lorsque les utilisateurs sont invités à donner leur autorisation.
Afficher les journaux Google Cloud et Rapports d'erreur dans la console Google Cloud
Si vous utilisez Google Cloud Logging ou Error Reporting de votre projet de script, vous pouvez consulter ces journaux et rapports Console Google Cloud en procédant comme suit:
- Ouvrez le projet Cloud.
- Cliquez sur Menu .
- Faites défiler la page jusqu'à la section Opérations. et cliquez sur Journalisation > Explorateur de journaux.
- Pour afficher les rapports d'erreurs, faites défiler la page jusqu'à la section Opérations. puis cliquez sur Error Reporting. Si vous êtes invité à configuré Error Reporting, cela signifie que votre projet de script n'a pas consigné des exceptions.
Complétez l'écran de consentement OAuth.
Lorsque des services nécessitent OAuth, Google invite les utilisateurs à les autoriser services. Les paramètres de l'écran de consentement OAuth vous permettent de définir certaines des informations que Google présente aux utilisateurs, 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 informations du projet Apps Script. Vous ne pouvez pas ajuster ces paramètres. Les projets Cloud standards vous permettent de personnaliser ces informations. Vous pouvez configurer le consentement de votre script à l'écran en procédant comme suit:
- Ouvrez le projet Cloud.
- Cliquez sur Menu > API et Services > Identifiants. .
- Cliquez sur Configurer l'écran d'autorisation.
- Remplissez chaque section du workflow de l'écran de consentement.
- 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 votre script utilise. Pour certaines applications, vous devez créer des Identifiants OAuth (ID client et codes secrets du client) Vous ne pouvez le faire qu'avec les projets standards.
Pour créer un ID et un code secret de client pour votre projet de script, procédez comme suit : suivantes:
- Ouvrez le projet Cloud.
- Cliquez sur Menu > API et services > Identifiants.
- Cliquez sur Créer des identifiants > ID client OAuth :
- 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.
- Dans la boîte de dialogue qui s'affiche, cliquez sur Télécharger au format JSON. Vous pouvez utilisez ce fichier pour configurer OAuth.
Ajouter des propriétaires supplémentaires à un projet Cloud standard
Vous pouvez ajouter des propriétaires supplémentaires ou d'autres rôles à un projet standard. Si vous collaborez sur un projet, cela permet de garantir qu'un membre de votre a toujours accès aux paramètres Google Cloud du projet de script.
Vous pouvez ajouter des propriétaires supplémentaires ou d'autres rôles à un projet standard en effectuant la suivis. Vous devez être autorisé à apporter des modifications au projet pour effectuer l'une des ces modifications:
- Déterminez qui doivent être vos collaborateurs. Nous vous recommandons créer ou utiliser un groupe Google existant. Vous pouvez également spécifier des domaines dans la liste des collaborateurs pour inclure tous les utilisateurs domaine.
- Ouvrez le projet Cloud du script.
- Cliquez sur Menu > IAM et administration > IAM.
- En haut de la page, cliquez sur Ajouter.
- Suivez les instructions à l'écran pour ajouter un ou plusieurs membres et leurs rôles au projet Cloud. Vous pouvez ajouter des adresses e-mail individuelles, des Google Groupes ou des domaines en tant que nouveaux membres.
- Cliquez sur Enregistrer.
Regrouper plusieurs scripts dans un seul projet Cloud
Vous pouvez faire en sorte que plusieurs projets Apps Script partagent la même norme Google Cloud. Pour ce faire, créez un projet standard, puis switch chaque projet de script pour l'utiliser. Cela n'est pas possible avec les projets par défaut.
Utiliser un autre projet Cloud standard
Vous pouvez modifier un projet de script afin qu'il utilise un autre projet Cloud standard. Si votre script nécessite une configuration manuelle Google Cloud, vous devez passer d'un projet par défaut à un projet projet. Pour savoir quand utiliser un projet standard, consultez les 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, les effets suivants se produisent :
- Si vous avez activé les services avancés pour votre script, vous devez activer le les API correspondantes le nouveau projet Cloud. Vous perdez toutes les données liées au dans le projet Cloud précédent. Découvrez 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 le
l'API Drive dans les projets Cloud standards ;
Dans votre projet Cloud standard, activez l'API Drive:
- Tous les utilisateurs ayant déjà autorisé le script doivent l'autoriser à nouveau. Dans la plupart des cas, tous les utilisateurs qui ont déjà autorisé les applications associées au nouveau projet doivent également les réautoriser.
- Si votre script est associé à une fiche d'application sur Google Workspace Marketplace, la fiche, les utilisateurs et les avis de votre application ne sont pas transférés un nouveau projet. Vous devez créer une fiche d'application dans le nouveau projet et votre les utilisateurs doivent réinstaller votre application. Pour en savoir plus sur la création consultez l'article Publier une application.
- Vous ne pouvez pas rétablir un projet par défaut pour un script. Suppressions Apps Script les projets par défaut une fois que vous avez défini 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 Google Cloud, procédez comme suit:
- Si vous ne disposez pas d'un projet Cloud approprié, créez-en un en suivant les instructions de la section Créer un projet. Choisissez un nom de projet facile à retenir afin de pouvoir localisez-le sur la page Gérer les ressources de la console Google Cloud. Apps Script utilise ce nom lorsque demandant aux utilisateurs d'autoriser le script.
- Si vous souhaitez utiliser un projet existant, ouvrez la page Gérer les ressources de la console Google Cloud et localiser un projet existant à utiliser. Vous devez disposer des rôles "Project Browser" (Navigateur de projet) et "OAuth Config Editor" (É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.
- Déterminez le numéro de votre projet Cloud.
- Ouvrez le script dont vous souhaitez remplacer le projet Cloud.
- Sur la gauche, cliquez sur Paramètres du projet.
- Sous Projet Google Cloud Platform (GCP), cliquez sur Changer de projet.
- Saisissez le numéro du nouveau projet, puis cliquez sur Définir le projet.
Projets cloud Drive partagés
Les Drive partagés (anciennement Drive d'équipe) vous permettent Espaces partagés où des groupes d'utilisateurs Drive peuvent collaborer sur Apps Script projets et documents Drive. Les Drive partagés sont utiles pour développer scripts, modules complémentaires et applications Web avec une équipe, mais ils imposent des restrictions sur avec les anciens projets Cloud par défaut.
La liste de restrictions suivante décrit les interactions entre les projets Cloud avec les Drive partagés:
- Si votre projet de script utilise un projet standard, des restrictions supplémentaires lorsque le projet de script 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, 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
À compter du 8 avril 2019, les restrictions suivantes s'appliquent tant que le script
se trouve sur un Drive partagé:
- Vous ne pouvez pas accéder au projet par défaut à l'aide de l'UI Apps Script ni de la console Google Cloud. Cette restriction vous empêche de suivre les actions nécessitant un accès direct au projet.
- Vous ne pouvez pas activer les services avancés. Pour activer les services avancés, passez à un projet.
- Lorsque vous déplacez un projet Apps Script existant vers un Drive partagé, Google restreint 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. Pour exemple : si vous avez créé un script dans votre dossier Mon Drive, puis déplacé dans un Drive partagé, vous pourrez toujours accéder au fichier Google Cloud. Vos collaborateurs dans le Drive partagé ne pourront peut-être pas y accéder.
- Un script conserve le nom du projet Cloud dont il disposait 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 au moment de l'autorisation. dans les boîtes de dialogue.
Pour éviter les restrictions ci-dessus pour les scripts plus anciens, passer à un projet standard.
Obtenir la liste des projets Cloud Apps Script
Si vous disposez de l'autorisation resourcemanager.projects.list
pour votre
dans le dossier de projet Apps Script de votre organisation, vous pouvez afficher tous les rôles
projets Cloud Apps Script par défaut dans le dossier.
- Ouvrez la page Gérer les ressources de la console Google Cloud.
- À côté du dossier Apps Script, copiez l'ID.
- Cliquez sur Filtrer > ID parent, puis collez-les. l'ID du dossier Apps Script.
Supprimer les projets Cloud Apps Script
Pour supprimer un projet Cloud Apps Script, suivez la procédure décrite dans la section Obtenir un liste des projets Cloud Apps Script, sélectionnez le projet à supprimer, puis cliquez sur Supprimer.
Pour supprimer un projet Apps Script à l'aide de gcloud
, utilisez le code suivant :
commandes.
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 la page Arrêter (supprimer) des projets.