Google Sheets est une solution de feuilles de calcul dans le cloud qui favorise la collaboration en temps réel et fournit des outils pour visualiser, traiter et communiquer les données.
Ce tutoriel explique comment créer et déployer un workflow qui crée un point de terminaison de rappel (ou webhook), enregistre l'URL de rappel dans Google Sheets, interrompt son exécution, puis attend une approbation humaine via la feuille de calcul Sheets pour redémarrer le workflow. En savoir plus sur l'utilisation des rappels
Objectifs
Au cours de ce tutoriel, vous allez :
- Créez un dossier dans Google Drive. Ce dossier est utilisé pour stocker votre feuille de calcul et permet au workflow d'y écrire.
- Créez une feuille de calcul Google Sheets pour enregistrer une approbation et lancer un rappel de workflow.
- Utilisez Google Apps Script, une plate-forme JavaScript basée dans le cloud qui vous permet de créer, lire et modifier des produits Google Workspace de manière automatisée, afin de déclencher la reprise d'un workflow suspendu chaque fois qu'une requête est approuvée via une mise à jour de la feuille de calcul.
- Créez et déployez un workflow qui appelle le connecteur d'API Google Sheets pour ajouter des données à la feuille de calcul. Le workflow s'exécute, se met en pause, puis reprend lorsqu'un rappel est approuvé via la feuille de calcul. En savoir plus sur les connecteurs Workflows
- Testez l'ensemble du processus et confirmez qu'il se déroule comme prévu.
Coûts
Dans ce document, vous utilisez les composants facturables suivants de Google Cloud :
Obtenez une estimation des coûts en fonction de votre utilisation prévue à l'aide du simulateur de coût.
Le tutoriel utilise également Google Workspace. Les services professionnels non inclus dans les applications grand public gratuites de Google sont facturables.
Avant de commencer
Vous pouvez exécuter certaines des commandes suivantes dans la console Google Cloud, ou à l'aide de la Google Cloud CLI dans votre terminal ou dans Cloud Shell.
Les contraintes de sécurité définies par votre organisation peuvent vous empêcher d'effectuer les étapes suivantes. Pour obtenir des informations de dépannage, consultez la page Développer des applications dans un environnement Google Cloud limité.
Console
Dans la console Google Cloud, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
activer les API Compute Engine, Sheets et Workflows ;
Notez le compte de service Compute Engine par défaut, car vous l'associerez au workflow de ce tutoriel à des fins de test. Pour les nouveaux projets ayant activé l'API Compute Engine, ce compte de service est créé avec le rôle IAM d'éditeur de base et au format d'adresse e-mail suivant:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Vous trouverez le numéro de votre projet sur la page Accueil de la console Google Cloud.
Pour les environnements de production, nous vous recommandons vivement de créer un compte de service et de lui attribuer un ou plusieurs rôles IAM contenant les autorisations minimales requises et respectant le principe du moindre privilège.
gcloud
Dans la console Google Cloud, activez Cloud Shell.
En bas de la fenêtre de la console Google Cloud, une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
Vérifiez que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
activer les API Compute Engine, Sheets et Workflows ;
gcloud services enable \ compute.googleapis.com \ sheets.googleapis.com \ workflows.googleapis.com
Notez le compte de service Compute Engine par défaut, car vous l'associerez au workflow de ce tutoriel à des fins de test. Pour les nouveaux projets ayant activé l'API Compute Engine, ce compte de service est créé avec le rôle IAM d'éditeur de base et au format d'adresse e-mail suivant:
PROJECT_NUMBER-compute@developer.gserviceaccount.com
Vous pouvez récupérer votre numéro de projet:
gcloud projects describe PROJECT_ID
Pour les environnements de production, nous vous recommandons vivement de créer un compte de service et de lui attribuer un ou plusieurs rôles IAM contenant les autorisations minimales requises et respectant le principe du moindre privilège.
Créer un dossier dans Google Drive
Créez un dossier dans Google Drive. Ce dossier est utilisé pour stocker votre feuille de calcul. En configurant une autorisation pour le dossier partagé, votre workflow est autorisé à écrire dans la feuille de calcul.
- Accédez à drive.google.com.
- Cliquez sur Nouveau > Nouveau dossier.
- Attribuez un nom au dossier.
- Cliquez sur Créer.
- Effectuez un clic droit sur le nouveau dossier, puis sélectionnez Partager.
Ajoutez l'adresse e-mail du compte de service Compute Engine par défaut.
Le compte de service peut ainsi accéder au dossier. Lorsque vous associez le compte de service à votre workflow, celui-ci est autorisé à modifier tous les fichiers du dossier. En savoir plus sur le partage de fichiers, de dossiers et de Drive
Sélectionnez le rôle Éditeur.
Décochez la case Envoyer une notification.
Cliquez sur Partager,
Créer une feuille de calcul avec Google Sheets
Lorsque vous créez une feuille de calcul avec Google Sheets, elle est enregistrée dans Google Drive. Par défaut, la feuille de calcul est enregistrée dans votre dossier racine sur Drive. Il n'existe pas d'option permettant de créer une feuille de calcul directement dans un dossier donné. Toutefois, il existe des alternatives, comme déplacer la feuille de calcul vers un dossier spécifique après l'avoir créée, comme dans cet exemple. Pour en savoir plus, consultez Travailler avec des dossiers Google Drive.
Accédez à sheets.google.com.
Cliquez sur New (Nouveau)
.
Votre nouvelle feuille de calcul est alors créée. Chaque feuille de calcul possède une valeur
spreadsheetId
unique, contenant des lettres, des chiffres, des traits d'union ou des traits de soulignement. Vous pouvez trouver l'ID de la feuille de calcul dans une URL Google Sheets:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
Notez cet ID, car vous en aurez besoin à la création du workflow.
Ajoutez des en-têtes de colonne pour qu'ils correspondent à l'exemple suivant:
Notez que la valeur de la colonne G, Approved?, permet d'initier des rappels dans le workflow.
Déplacez la feuille de calcul vers le dossier Google Drive que vous avez créé précédemment:
- Dans la feuille de calcul, sélectionnez Fichier > Déplacer.
- Accédez au dossier que vous avez créé.
- Cliquez sur Déplacer.
Vous pouvez également créer une feuille de calcul à l'aide du connecteur d'API Google Sheets. Notez que lorsque vous utilisez le connecteur, la valeur spreadsheetId
peut être récupérée à partir du résultat resp
.
Exemple :
- create_spreadsheet: call: googleapis.sheets.v4.spreadsheets.create args: body: connector_params: scopes: ${driveScope} result: resp - assign_sheet_id: assign: - sheetId: ${resp.spreadsheetId}
Étendre les feuilles de calcul Google Sheets à l'aide d'Apps Script
Apps Script vous permet de créer, lire et modifier des feuilles de calcul Google Sheets par programmation. La plupart des scripts conçus pour Sheets manipulent les tableaux pour interagir avec les cellules, les lignes et les colonnes d'une feuille de calcul. Pour découvrir comment utiliser Apps Script avec Google Sheets, consultez le guide de démarrage rapide des fonctions personnalisées.
Créez un projet Apps Script à partir de Google Sheets:
- Ouvrez votre feuille de calcul Sheets.
- Sélectionnez Extensions > Apps Script.
- Dans l'éditeur de script, cliquez sur Projet sans titre.
- Attribuez un nom à votre projet, puis cliquez sur Renommer.
Votre script est désormais lié à votre feuille de calcul, ce qui lui permet de modifier l'interface utilisateur ou de répondre lorsque la feuille de calcul est ouverte.
Un projet de script représente un ensemble de fichiers et de ressources Apps Script. Les fichiers de code d'un projet de script possèdent une extension
.gs
.Vous pouvez utiliser Apps Script pour écrire des fonctions personnalisées que vous pouvez utiliser dans Google Sheets comme une fonction intégrée. Les fonctions personnalisées sont créées en JavaScript standard. Créez une fonction:
- Ouvrez votre projet Apps Script.
- Cliquez sur Éditeur .
- Un fichier de script s'affiche en tant que fichier de projet nommé
Code.gs
. Pour modifier le fichier, sélectionnez-le. Remplacez tout code dans l'éditeur de script par le code suivant, qui lit les données de votre feuille de calcul et les transmet en tant qu'entrée à l'exécution d'un workflow:
Cliquez sur Enregistrer
.
Les déclencheurs installables d'Apps Script permettent à un projet de script d'exécuter une fonction spécifiée lorsque certaines conditions sont remplies, par exemple lorsqu'une feuille de calcul est ouverte ou modifiée. Créez un déclencheur:
- Ouvrez votre projet Apps Script.
- Cliquez sur Déclencheurs .
- Cliquez sur Ajouter un déclencheur.
- Dans la boîte de dialogue Ajouter un déclencheur pour YOUR_PROJECT_NAME, configurez le déclencheur :
- Dans la liste Choisir la fonction à exécuter, sélectionnez handleEdit.
- Dans la liste Choisir le déploiement à exécuter, sélectionnez Head.
- Dans la liste Sélectionner la source de l'événement, choisissez À partir de la feuille de calcul.
- Dans la liste Sélectionnez un type d'événement, choisissez Lors d'une modification.
- Dans la liste Paramètres de notification des échecs, sélectionnez M'envoyer une notification quotidienne.
- Cliquez sur Enregistrer.
Si vous êtes invité à choisir un compte Google, sélectionnez le compte approprié, puis cliquez sur Allow (Autoriser).
Votre projet Apps Script peut ainsi afficher, modifier, créer et supprimer vos feuilles de calcul Google Sheets, et se connecter à un service externe.
Un fichier manifeste d'un projet Apps Script est un fichier JSON qui fournit les informations de base nécessaires à l'exécution d'un script dans Apps Script. Notez que l'éditeur Apps Script masque les fichiers manifestes par défaut pour protéger les paramètres de votre projet Apps Script. Modifiez le fichier manifeste:
- Ouvrez votre projet Apps Script.
- Cliquez sur Paramètres du projet .
- Cochez la case Afficher le fichier manifeste "appsscript.json" dans l'éditeur.
- Cliquez sur Éditeur .
- Le fichier manifeste apparaît sous la forme d'un fichier de projet nommé
appsscript.json
. Pour modifier le fichier, sélectionnez-le. Le champ
oauthScopes
spécifie un tableau de chaînes. Pour définir les niveaux d'autorisation que votre projet utilise, ajoutez un tableau indiquant les niveaux d'accès que vous souhaitez utiliser. Par exemple,{ "timeZone": "America/Toronto", "dependencies": { }, "exceptionLogging": "STACKDRIVER", "runtimeVersion": "V8", "oauthScopes": [ "https://www.googleapis.com/auth/script.external_request", "https://www.googleapis.com/auth/cloud-platform", "https://www.googleapis.com/auth/spreadsheets" ] }
.Les champs d'application explicites sont ainsi définis sur:
- Se connecter à un service externe.
- Consulter, modifier, configurer et supprimer vos données Google Cloud, et afficher l'adresse e-mail de votre compte Google
- Consulter, modifier, créer et supprimer toutes vos feuilles de calcul Google Sheets
Cliquez sur Enregistrer
.
Déployer un workflow qui écrit dans une feuille de calcul et utilise des rappels
Déployez un workflow qui s'exécute, se met en pause, puis reprend lorsqu'un rappel est approuvé via une feuille de calcul. Le workflow écrit dans une feuille de calcul Sheets à l'aide du connecteur d'API Google Sheets.
Console
Dans la console Google Cloud, accédez à la page Workflows:
Cliquez sur
Créer.Saisissez un nom pour le nouveau workflow:
workflows-awaits-callback-sheets
.Dans la liste Région, sélectionnez us-central1 (Iowa).
Dans le champ Compte de service, sélectionnez le compte de service Compute Engine par défaut (
PROJECT_NUMBER-compute@developer.gserviceaccount.com
).Cliquez sur Suivant.
Dans l'éditeur de workflow, saisissez la définition suivante pour votre workflow:
Veillez à remplacer la valeur de l'espace réservé
sheetId
par votrespreadsheetId
.Cliquez sur Déployer.
gcloud
Créez un fichier de code source pour votre workflow:
touch workflows-awaits-callback-sheets.yaml
Dans un éditeur de texte, copiez le workflow suivant dans votre fichier de code source:
Veillez à remplacer la valeur de l'espace réservé
sheetId
par votrespreadsheetId
.Déployez le workflow en saisissant la commande suivante :
gcloud workflows deploy workflows-awaits-callback-sheets \ --source=workflows-awaits-callback-sheets.yaml \ --location=us-central1 \ --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
Remplacez
PROJECT_NUMBER
par votre numéro de projet Google Cloud. Vous pouvez récupérer votre numéro de projet:gcloud projects describe PROJECT_ID
Tester le flux de bout en bout
Exécutez le workflow pour tester le flux de bout en bout. L'exécution d'un workflow s'exécute sur la définition du workflow actuel qui lui est associée.
Console
Dans la console Google Cloud, accédez à la page Workflows:
Sur la page Workflows, sélectionnez le workflow workflows-awaits-callback-sheets pour accéder à sa page d'informations.
Sur la page Détails du workflow, cliquez sur play_arrow Exécuter.
Cliquez à nouveau sur Exécuter.
Le workflow démarre, et son état d'exécution doit être Running (En cours d'exécution). Les journaux indiquent également que le workflow est suspendu et en attente:
Execute steps here before waiting for callback from sheets ... Started waiting for callback from sheet 1JlNFFnqs760M_KDqeeeDc_qtrABZDxoalyCmRE39dpM
Vérifiez que le workflow a écrit les détails du rappel sur une ligne de votre feuille de calcul.
Par exemple, vous devriez voir l'ID d'exécution de votre workflow dans la colonne Execution ID (ID d'exécution), un point de terminaison de rappel dans la colonne Callback URL (URL de rappel) et FALSE (FAUX) dans la colonne Approved? (Approuvé).
Dans la feuille de calcul, remplacez FALSE par TRUE.
Au bout d'une minute ou deux, l'exécution doit reprendre et se terminer avec l'état Succeeded (Réussie).
gcloud
Ouvrez un terminal.
Exécutez le workflow :
gcloud workflows run workflows-awaits-callback-sheets
Le workflow démarre, et le résultat doit indiquer qu'il est en pause et en attente:
Waiting for execution [a8361789-90e0-467f-8bd7-ea1c81977820] to complete...working.
Vérifiez que le workflow a écrit les détails du rappel sur une ligne de votre feuille de calcul.
Par exemple, vous devriez voir l'ID d'exécution de votre workflow dans la colonne Execution ID (ID d'exécution), un point de terminaison de rappel dans la colonne Callback URL (URL de rappel) et FALSE (FAUX) dans la colonne Approved? (Approuvé).
Dans la feuille de calcul, remplacez FALSE par TRUE.
Après une ou deux minutes, l'exécution doit reprendre et se terminer avec l'état
SUCCEEDED
.
Effectuer un nettoyage
Si vous avez créé un projet pour ce tutoriel, supprimez-le. Si vous avez utilisé un projet existant et que vous souhaitez le conserver sans les modifications du présent tutoriel, supprimez les ressources créées pour ce tutoriel.
Supprimer le projet
Le moyen le plus simple d'empêcher la facturation est de supprimer le projet que vous avez créé pour ce tutoriel.
Pour supprimer le projet :
- Dans la console Google Cloud, accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.