Consultez la liste des connecteurs compatibles avec Application Integration.

Tâche Sheets – Get

La tâche Sheets – Get vous permet de lire et de récupérer une seule plage de valeurs dans une feuille de calcul Google.

Google Sheets est l'une des nombreuses solutions de productivité basées sur le cloud disponibles dans Google Workspace. Il vous permet de créer et de modifier des feuilles de calcul en ligne avec une fonctionnalité de collaboration en temps réel.

Avant de commencer

Assurez-vous d'effectuer les tâches suivantes dans votre projet Google Cloud avant de configurer la tâche Sheets – Get :

Activez l'API Google Sheets (sheets.googleapis.com).
Activer l'API Google Sheets
Créer un profil d'authentification Application Integration se sert d'un profil d'authentification pour se connecter à un point de terminaison d'authentification pour la tâche Sheets - Get.
Pour en savoir plus sur l'attribution de rôles ou d'autorisations supplémentaires à un compte de service, consultez la page Accorder, modifier et révoquer des accès.
Découvrez les termes courants utilisés dans Google Sheets.

Configurer la tâche Sheets – Get

Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Integrations (Intégrations).
La page Intégrations s'affiche. Elle liste toutes les intégrations disponibles dans le projet Google Cloud.
Sélectionnez une intégration existante ou cliquez sur Créer une intégration pour en créer une.
Si vous créez une intégration:
1. Saisissez un nom et une description dans le volet Créer une intégration.
2. Sélectionnez une région pour l'intégration.
  Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment depuis le volet Résumé de l'intégration de dans la barre d'outils d'intégration.
  Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
La page de l'éditeur d'intégration s'affiche.
Dans la barre de navigation de l'éditeur d'intégration, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
Cliquez sur l'élément Sheets - Get et placez-le dans l'éditeur d'intégration.
Cliquez sur l'élément Sheets – Get du concepteur pour ouvrir le volet de configuration de la tâche Sheets – Get.
Accédez à Authentification, puis sélectionnez un profil d'authentification existant que vous souhaitez utiliser.
Facultatif. Si vous n'avez pas créé de profil d'authentification avant de configurer la tâche, cliquez sur + Nouveau profil d'authentification et suivez les étapes mentionnées dans la section Créer un profil d'authentification.
Accédez à l'Entrée de la tâche et configurez les champs d'entrée affichés à l'aide du tableau Paramètres d'entrée de la tâche suivant.
Les modifications apportées aux champs d'entrée sont enregistrées automatiquement.

Paramètres d'entrée de la tâche

Le tableau suivant décrit les paramètres d'entrée de la tâche Sheets – Get :

Propriété	Type de données	Description
SpreadsheetId	Chaîne	ID de votre feuille de calcul L'ID de votre feuille de calcul se trouve dans son URL Web. Par exemple : `https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit#gid=0`
MajorDimension	enum (Dimension)	Catégorie ou dimension principale à appliquer. Par exemple, `ROWS` ou `COLUMNS`. Valeur par défaut:`DIMENSION_UNSPECIFIED`
Plage	Chaîne	Notation A1 ou R1C1 de la plage à partir de laquelle récupérer les valeurs.
dateTimeRenderOption	enum (DateTimeRenderOption)	Indique comment les valeurs liées à la date, à l'heure et à la durée sont représentées dans le résultat. Remarque : dateTimeRenderOption n'est pas pris en compte si la valeur spécifiée pour valueRenderOption est `FORMATTED_VALUE`. Valeur par défaut:`SERIAL_NUMBER`
ValueRenderOption	enum (ValueRenderOption)	Indique comment les valeurs récupérées sont représentées dans le résultat. Valeur par défaut:`FORMATTED_VALUE`

Résultat de la tâche

La tâche Sheets – Get renvoie le résultat de la réponse contenant un objet ValueRange correspondant à la plage demandée. Voici un exemple de résultat :

    {
        "range": "Sheet1!A1:D5",
        "majorDimension": "ROWS",
        "values": [
          ["Item", "Cost", "Stocked", "Ship Date"],
          ["Wheel", "$20.50", "4", "42430"],
          ["Door", "$15", "2", "42444"],
          ["Engine", "$100", "1", "42449"],
          ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
        ],
      }

Stratégie de traitement des erreurs

Une stratégie de traitement des erreurs d'une tâche spécifie l'action à effectuer si celle-ci échoue en raison d'une erreur temporaire. Pour en savoir plus sur l'utilisation et les différents types de stratégies de traitement des erreurs, consultez la page Stratégies de traitement des erreurs.

Étapes suivantes

Ajoutez des arêtes et conditions d'arêtes.
Testez et publiez votre intégration.
Configurez un déclencheur.
Ajoutez une tâche de mappage de données.
Consultez toutes les tâches des services Google Cloud.