Écrire dans Google Sheets à partir d'un workflow

Google Sheets est une solution de feuille de calcul basée sur le cloud qui prend en charge la collaboration en temps réel et fournit des outils pour visualiser, traiter et communiquer des données.

L'exemple suivant montre comment écrire dans Sheets à partir d'un workflow. Le workflow interroge un ensemble de données BigQuery et écrit les résultats dans une feuille de calcul Sheets. Il utilise des connecteurs Workflows pour simplifier l' appel des Google Cloud API.

Avant de commencer

Avant d'essayer l'exemple de ce document, assurez-vous d'avoir effectué les opérations suivantes.

  1. Activez les API Compute Engine, Google Drive, Google Sheets et Workflows.

    Console

    Activer les API

    gcloud 

    gcloud services enable \
    compute.googleapis.com \
    drive.googleapis.com \
    sheets.googleapis.com \
    workflows.googleapis.com

  2. Notez le compte de service Compute Engine par défaut , car vous l'associerez à l'exemple de workflow à des fins de test. Les nouveaux projets pour lesquels l'API Compute Engine est activée disposent de ce compte de service créé avec le rôle IAM de base Éditeur et avec le format d'adresse e-mail suivant :

    PROJECT_NUMBER-compute@developer.gserviceaccount.com

    Vous pouvez trouver le numéro de votre projet sur la page Bienvenue de la Google Cloud console ou le récupérer :

    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 conformément au principe du moindre privilège.

  3. 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.

    1. Accédez à drive.google.com.
    2. Cliquez sur Nouveau > Nouveau dossier.
    3. Saisissez le nom du dossier.
    4. Cliquez sur Créer.
    5. Effectuez un clic droit sur votre nouveau dossier, puis sélectionnez Partager.

    6. Ajoutez l'adresse e-mail du compte de service Compute Engine par défaut.

      Cela donne au compte de service l'accès au dossier. Lorsque vous associez le compte de service à votre workflow, celui-ci dispose d'un accès en modification à tous les fichiers du dossier. En savoir plus sur le partage de fichiers, de dossiers et de Drive.

    7. Sélectionnez le rôle Éditeur.

    8. Décochez la case Avertir les personnes.

    9. Cliquez sur Partager.

Créer une feuille de calcul

Vous pouvez créer une feuille de calcul de l'une des manières suivantes :

Il n'est pas possible de créer une feuille de calcul directement dans un dossier spécifié à l'aide de l'API Google Sheets. Toutefois, il existe des alternatives, y compris le déplacement de la feuille de calcul vers un dossier spécifique après sa création, comme dans les exemples suivants. Pour en savoir plus, consultez la section Utiliser des dossiers Google Drive.

Créer une feuille de calcul à l'aide de Google Sheets

Lorsque vous créez une feuille de calcul via 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.

  1. Accédez à sheets.google.com.

  2. Cliquez sur Nouveau Plus.

    La nouvelle feuille de calcul s'ouvre. Toute feuille de calcul est associée à une valeur unique spreadsheetId, composée de lettres, de chiffres, de traits d'union ou de traits de soulignement. Vous trouverez cet identifiant de feuille de calcul dans une URL Google Sheets :

    https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

  3. Notez cet ID, car vous en aurez besoin lorsque vous créerez votre workflow.

  4. Déplacez la feuille de calcul vers le dossier Google Drive que vous avez créé précédemment :

    1. Dans la feuille de calcul, sélectionnez Fichier > Déplacer.
    2. Accédez au dossier que vous avez créé.
    3. Cliquez sur Déplacer.

Créer une feuille de calcul à l'aide du connecteur de l'API Google Sheets

Vous pouvez utiliser le connecteur de l'API Google Sheets pour créer une feuille de calcul. Comme Workflows utilise le compte de service comme identité de déclencheur, la feuille de calcul est créée dans le dossier racine Google Drive du compte de service. Vous pouvez ensuite déplacer la feuille de calcul vers un autre dossier.

Dans le workflow suivant, le spreadsheetId est récupéré à partir du résultat resp :

YAML

main: